terraform provider citrixadcダウンロード - terraform provider citrixadcソースコードのダウンロード

terraform provider citrixadc

その他のソースコード

v1.42.0

ダウンロード

Terraform `Citrix ADC`プロバイダー

Citrix は、Citrix ADC の導入と構成を自動化するカスタム Terraform プロバイダーを開発しました。 Terraform を使用すると、ロードバランシング、SSL、コンテンツスイッチング、GSLB、WAF などのさまざまなユースケースに合わせて ADC をカスタム構成できます。

Citrix ADC オートメーションの詳細については、こちらをご覧ください。

?パブリッククラウド（AWSおよびAzure）にCitrix ADCを展開する場合は、githubリポジトリのterraform-cloud-scriptsでクラウドスクリプトを確認してください。

✉️ 緊急の問題やサポートが必要な場合は、[email protected] までご連絡ください。

例とモジュール

例を参照
Golden_templates も参照してください

Terraform プロバイダーのドキュメント

Citrix ADC に Terraform を使用する理由
リポジトリのナビゲート
プロバイダー構成について
リソース構成を理解する
ADC 構成に関する一般的なガイドライン
Citrix ADC の永続ストアへの変更のコミット
Terraform を通じてサポートされる ADC ユースケースのリスト
ワンタイムタスクにremote-execを使用する

Terraform を使用して ADC を自動化するための初心者ガイド

Terraform を使用した ADC 自動化のハンズオンラボ
Terraform を独自のセットアップにインストールする
ADC Terraform プロバイダーリポジトリについて)
最初の Terraform 構成を ADC に取得する
ADC 用の Terraform リソースファイルの作成方法
ADC で SSL オフロードのユースケースをセットアップする
Citrix ADC の永続ストアへの変更のコミット
Terraform での ADC 構成のドリフトの管理
ADC 構成を Terraform リソースファイルにインポートする

Terraform を使用した ADC の自動化に関する高度なガイド

Terraform を使用して AWS に ADC をデプロイする
Terraform ワークスペースを活用して複数の ADC を管理する
Consul-Terraform-Sync を使用してサービスを動的に更新する
Citrix ADC と Azure Pipelines を使用した Blue-Green デプロイメント

Citrix ADC に Terraform を使用する理由

Terraform は、数百ものクラウドサービスを管理するための一貫した CLI ワークフローを提供するコードソフトウェアツールとしてのオープンソースインフラストラクチャです。Terraform は、クラウド API を宣言型構成ファイルに体系化します。 Terraform を使用して ADC を展開および構成できます。 Terraform を介して Citrix ADC を構成すると、複数の利点が得られます。

ADC へのインフラストラクチャアズコードアプローチ - ADC 構成を GitHub などの scm ツールに保存し、他のコードリポジトリと同様にバージョンを追跡できます。
ADC 自動化への宣言型アプローチ - ユーザーは ADC のターゲット状態を定義するだけで済みます。 ADC terraform リソースは、ターゲット状態を達成するために適切な API 呼び出しを行います。
Terraform の ADC リソースファイルは人間にとって使いやすく、理解しやすいものです。
Citrix ADC の内部アーキテクチャに関連する複雑さを抽象化します。
Terraform を通じて ADC の構成のドリフトを簡単に検出します。

リポジトリ内の移動

citrixadcフォルダー - Terraform を通じてサポートされるすべての ADC リソースライブラリが含まれています。これらのリソースライブラリは、内部で NITRO APIS を呼び出して、ターゲット ADC を構成します。
examplesフォルダー - ユーザーがさまざまな ADC リソースを使用するためのサンプルが含まれています。たとえば、simple_lb フォルダーには、citrixadc_lbvserver リソースを使用してターゲット ADC 上にロードバランシング vserver を作成する方法を示す resource.tf が含まれています。同様に、さまざまなフォルダーに、さまざまなリソースの定義に関する例が含まれています。ユーザーはこれらの例を確認し、必要な ADC 構成を定義することが期待されます。
docsフォルダー - https://github.com/citrix/terraform-provider-citrixadc/tree/master/docs/resources - Terraform を通じてサポートされるすべてのリソース構成のドキュメントが含まれています。特定のリソースが取るさまざまな引数や値を理解するには、これを参照してください。

プロバイダー構成について

provider.tf構成を適用するターゲット ADC に関する情報が含まれています。

 provider "citrixadc" {
    username = " ${ var . ns_user } "  # You can optionally use `NS_LOGIN` environment variables.
    password = " ${ var . ns_password } "  # You can optionally use `NS_PASSWORD` environment variables.
    endpoint = " http://10.71.136.250/ "  # You can optionally use `NS_URL` environment variables.
}

https URLを使用し、 insecure_skip_verify = trueと指定することで、Citrix ADCで信頼できない認証局の証明書を受け入れることができます。

insecure_skip_verify = trueを設定せずにhttps使用するには、このガイドに従ってデフォルトの TLS 証明書を信頼できる証明機関からの証明書に置き換える方法を説明します。

httpsの使用が推奨されます。 http使用すると、すべてのプロバイダー構成変数とリソース変数がクリアテキストで送信されます。 HTTP データストリームを観察している人は誰でも、プロバイダーのパスワードなどの機密性の高い値を解析できます。

暗号化をサポートするバックエンドを使用して、プロバイダーの資格情報をローカル状態に保存しないようにします。 hasicorp ボールトプロバイダーは、機密データの保存にも推奨されます。

上記のコメントで述べたように、環境変数を使用することもできます。

次の引数がサポートされています。

username - これは、Citrix ADC にアクセスするためのユーザー名です。環境変数NS_LOGINが設定されていない場合、デフォルトはnsrootです。
password - これはCitrix ADCにアクセスするためのパスワードです。環境変数NS_PASSWORDが設定されていない限り、デフォルトはnsrootになります。
endpoint - (必須) http://<NS_IP>/またはhttp://<NS_IP>:<PORT>/形式の Nitro API エンドポイント。環境変数NS_URLで指定可能

insecure_skip_verify - (オプション、true/false) Citrix ADC エンドポイントがhttps場合に、Citrix ADC で信頼できない証明書を受け入れるかどうか

proxied_ns - (オプション、NSIP) MAS プロキシ呼び出しのターゲット Citrix ADC NSIP。このオプションが定義されている場合、 username 、 password 、およびendpoint MAS プロキシを参照する必要があります。

ユーザー名、パスワード、およびエンドポイントは、環境変数NS_LOGIN 、 NS_PASSWORD 、およびNS_URLで指定できます。

リソース構成

Resources.tf には、ターゲット ADC 上で必要なリソースの望ましい状態が含まれています。たとえば、ADC でロードバランシング vserver を作成する場合、次の resource.tf には lbvserver の必要な構成が含まれます。

citrixadc_lbvserver

 resource "citrixadc_lbvserver" "foo" {
  name = " sample_lb "
  ipv46 = " 10.71.136.150 "
  port = 443
  servicetype = " SSL "
  lbmethod = " ROUNDROBIN "
  persistencetype = " COOKIEINSERT "
  sslcertkey = " ${ citrixadc_sslcertkey . foo . certkey } "
  sslprofile = " ns_default_ssl_profile_secure_frontend "
}

特定のリソースで使用できる引数、可能な値、およびその他の引数を理解するには、NITRO API ドキュメント https://developer-docs.citrix.com/projects/netscaler-nitro-api/en/12.0/configuration/ を参照してください。 load-balancing/lbvserver/lbvserver/ および Terraform ドキュメントなどhttps://github.com/citrix/terraform-provider-citrixadc/blob/master/docs/resources/lbvserver.md 。

属性のstateはリモートオブジェクトと同期されていません。 lb vserver の状態が terraform 構成と同期していない場合は、リソースを手動で汚染し、構成を再度適用する必要があります。

ADC の設定に関する一般的なガイドライン

サンプルフォルダー内のサブフォルダーには、terraform によるさまざまな ADC 構成のサンプルが含まれています。以下の構造と使用法を理解するには、simple_lb の例を参照してください。

構造

resources.tf作成される実際の NetScaler 構成オブジェクトが記述されています。これらのリソースの属性は、ハードコーディングされるか、 terraform.tfvarsの入力変数から検索されます。
variables.tf terraform 構成への入力変数を記述します。これらにはデフォルトを設定できます
provider.tfは、NetScaler のユーザー名、パスワード、エンドポイントを指定するために使用されます。あるいは、NS_URL、NS_LOGIN、および NS_PASSWORD 環境変数を設定することもできます。
terraform.tfvarsは、 variables.tfで指定された変数入力があります。

使用する

独自の NetScaler デプロイメントに合わせて、 terraform.tfvarsとprovider.tf変更します。
terraform planとterraform applyを使用して NetScaler を構成します。

設定を更新する

バックエンドサービスのセットを変更し、 terraform planとterraform applyを使用して変更を確認します。

Citrix ADC の永続ストアへの変更のコミット

プロバイダーは、構成変更をCitrix ADCの永続ストアにコミットしません。これを行うには、シェルスクリプトns_commit.shを実行します。

 export NS_URL=http:// < host > : < port > /
export NS_LOGIN=nsroot
export NS_PASSWORD=nsroot
./ns_commit.sh

実行のたびに設定が確実に保存されるようにするには、 terraform apply && ns_commit.shのようなものを使用します。

Terraform を通じてサポートされる ADC ユースケース

ADC でサポートされているユースケースのリストは、https://registry.terraform.io/providers/citrix/citrixadc/latest/docs にあります。

ワンタイムタスクに`remote-exec`を使用する

Terraform は、リソースのセットの望ましい状態を維持するのに役立ちます。ネットワーク構成などの変更のないタスクにはあまり役に立ちません。ネットワーク構成は、Terraform 内でプロビジョナーを使用するようなものです。ディレクトリexamples/remote-exec Terraform が ssh を使用してこれらの 1 回限りのタスクを実行する方法の例が示されています。

Terraform による ADC 自動化の初心者ガイド

Terraform を使用した ADC 自動化のハンズオンラボ

ハンズオンラボを試して、ADC に Terraform を使用する様子を体験してください。

Terraform を独自のセットアップにインストールする

ADC に Terraform を使用するための最初のステップは、Terraform CLI をインストールすることです。独自の環境に Terraform CLI をインストールするには、Hashicorp のドキュメントを参照してください。

ADC Terraform プロバイダーリポジトリについて

「リポジトリのナビゲート」セクションを参照してください。

最初の Terraform 構成を ADC に取得する

NetScaler での Terraform の概要に関する記事に従って、最初の構成を取得します。

ADC 用の Terraform リソースファイルの作成方法

Citrix ADC の Terraform リソースを作成するには、次のリンクの NITRO API ドキュメントまたは Terraform レジストリドキュメントを参照してください。

ADC で SSL オフロードのユースケースをセットアップする

これは、SSL オフロードを構成するために使用する Terraform テンプレートです。

Citrix ADC の永続ストアへの変更のコミット

「変更のコミット」セクションを参照してください。

Terraform での ADC 構成のドリフトの管理

Terraform の ADC エンティティの現在の状態を確認したい

terraform リフレッシュを使用して、ローカルの terraform 状態ファイルを既存の ADC 状態と一致するように更新します。
terraform show を使用して、構成全体の現在の状態を表示します
Terraform 状態リストを使用して、Terraform 経由で追跡/管理されているリソースを表示します
特定のエンティティを検査するには、terraform state show <entity_name>を使用します。例: terraform state show citrixadc_servicegroup.tf_servicegroup

Terraform リソースファイルにある構成で ADC 構成をオーバーライドする場合は、次のようにします。

terraform plan を実行して、2 つの状態間のドリフト/差異を確認できます。
terraform apply を実行して、必要な構成 (Terraform リソースファイル内) を ADC にプッシュします。

ADC の現在/実際の状態を反映するように terraform 状態ファイルを更新します。

terraform リフレッシュを使用して、ローカルの terraform 状態ファイルを既存の ADC 状態と一致するように更新します。

ADC 構成を Terraform リソースファイルにインポートする

既存の NetScaler 構成を Terraform リソースにインポートする方法については、こちらをご覧ください。

Terraform を使用した ADC の自動化に関する高度なガイド

Terraform を使用して AWS に ADC をデプロイする

AWS 用の Terraform クラウドスクリプトとデモビデオを参照してください。

Terraform ワークスペースを活用して複数の ADC を管理する

未定

Consul-Terraform-Sync を使用してサービスを動的に更新する

Consul-Terraform-Sync の統合により、ユーザーは Consul Terraform Sync フレームワークと同期されるサービスグループを Citrix ADC で自動的に作成、更新、削除できます。

Citrix ADC と Azure Pipelines を使用した Blue-Green デプロイメント

ADC を統合し、Terraform を使用して Blue-Green 導入を容易にするように構成します。ソリューションを確認してください。

拡大する

追加情報

バージョン v1.42.0
タイプその他のソースコード
更新時間 2024-12-28
サイズ 14.02MB
から Github

terraform provider citrixadc

Terraform Citrix ADCプロバイダー

例とモジュール

Terraform プロバイダーのドキュメント

Terraform を使用して ADC を自動化するための初心者ガイド

Terraform を使用した ADC の自動化に関する高度なガイド

Citrix ADC に Terraform を使用する理由

リポジトリ内の移動

プロバイダー構成について

リソース構成

ADC の設定に関する一般的なガイドライン

構造

使用する

設定を更新する

Citrix ADC の永続ストアへの変更のコミット

Terraform を通じてサポートされる ADC ユースケース

ワンタイムタスクにremote-execを使用する

Terraform による ADC 自動化の初心者ガイド

Terraform を使用した ADC 自動化のハンズオン ラボ

Terraform を独自のセットアップにインストールする

ADC Terraform プロバイダー リポジトリについて

最初の Terraform 構成を ADC に取得する

ADC 用の Terraform リソース ファイルの作成方法

ADC で SSL オフロードのユースケースをセットアップする

Citrix ADC の永続ストアへの変更のコミット

Terraform での ADC 構成のドリフトの管理

ADC 構成を Terraform リソース ファイルにインポートする

Terraform を使用した ADC の自動化に関する高度なガイド

Terraform を使用して AWS に ADC をデプロイする

Terraform ワークスペースを活用して複数の ADC を管理する

Consul-Terraform-Sync を使用してサービスを動的に更新する

Citrix ADC と Azure Pipelines を使用した Blue-Green デプロイメント

Terraform `Citrix ADC`プロバイダー

ワンタイムタスクに`remote-exec`を使用する

Terraform を使用した ADC 自動化のハンズオンラボ

ADC Terraform プロバイダーリポジトリについて

ADC 用の Terraform リソースファイルの作成方法

ADC 構成を Terraform リソースファイルにインポートする