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 repo 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 공급자 저장소 이해)
ADC에 첫 번째 Terraform 구성 가져오기
ADC용 Terraform 리소스 파일을 작성하는 방법
ADC에서 SSL 오프로딩 사용 사례 설정
Citrix ADC의 영구 저장소에 변경 사항 커밋
Terraform에서 ADC 구성 드리프트 관리
ADC 구성을 Terraform 리소스 파일로 가져오기

Terraform을 사용한 ADC 자동화에 대한 고급 가이드

Terraform을 사용하여 AWS에 ADC 배포
Terraform 작업공간을 활용하여 여러 ADC 관리
Consul-Terraform-Sync를 사용하여 서비스를 동적으로 업데이트합니다.
Citrix ADC 및 Azure Pipelines를 사용한 블루-그린 배포

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에서 로드 밸런싱 가상 서버를 생성하는 방법을 보여주는 resources.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에서 로드 밸런싱 가상 서버를 생성하려면 다음 리소스에 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 가상 서버의 상태가 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를 사용하여 이러한 일회성 작업을 수행하는 방법의 예를 보여줍니다.

Terraform을 사용한 ADC 자동화 초보자 가이드

Terraform을 사용한 ADC 자동화 실습 랩

Hands on Lab을 통해 ADC용 Terraform을 사용하는 방법을 경험해 보세요.

자체 설정에 Terraform 설치

ADC용 Terraform을 사용하는 첫 번째 단계는 Terraform CLI를 설치하는 것입니다. 자신의 환경에 맞게 Terraform CLI를 설치하려면 Hashicorp 설명서를 참조하세요.

ADC Terraform 공급자 저장소 이해

저장소 탐색 섹션을 참조하세요.

ADC에 첫 번째 Terraform 구성 가져오기

첫 번째 구성을 얻으려면 NetScaler에서 Terraform 시작하기 문서를 따르세요.

ADC용 Terraform 리소스 파일을 작성하는 방법

Citrix ADC용 Terraform 리소스를 작성하려면 NITRO API 문서 또는 Terraform 레지스트리 문서 링크를 참조하세요.

ADC에서 SSL 오프로딩 사용 사례 설정

다음은 SSL 오프로딩을 구성하기 위해 따라야 하는 Terraform 템플릿입니다.

Citrix ADC의 영구 저장소에 변경 사항 커밋

변경사항 커밋 섹션을 참조하세요.

Terraform에서 ADC 구성 드리프트 관리

Terraform에서 ADC 엔터티의 현재 상태를 보고 싶습니다.

Terraform 새로 고침을 사용하여 기존 ADC 상태와 일치하도록 로컬 Terraform 상태 파일을 업데이트하세요.
Terraform show를 사용하여 전체 구성의 현재 상태를 표시하세요.
Terraform 상태 목록을 사용하여 Terraform을 통해 추적/관리되는 리소스를 표시합니다.
특정 엔터티를 검사하려면 terraform state show <entity_name> (예: terraform state show citrixadc_servicegroup.tf_servicegroup)을 사용하세요.

Terraform 리소스 파일에 있는 구성으로 ADC 구성을 재정의하려면 다음을 수행하세요.

Terraform 계획을 실행하여 두 상태 간의 드리프트/차이점을 확인할 수 있습니다.
Terraform Apply를 실행하여 원하는 구성(Terraform 리소스 파일에 있음)을 ADC에 푸시합니다.

ADC의 현재/실제 상태를 반영하도록 Terraform 상태 파일을 업데이트하세요.

Terraform 새로 고침을 사용하여 기존 ADC 상태와 일치하도록 로컬 Terraform 상태 파일을 업데이트하세요.

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를 사용한 블루-그린 배포

ADC를 통합하고 Terraform을 사용하여 블루-그린 배포를 촉진하도록 구성합니다. 솔루션을 확인하세요.

확장하다

추가 정보

버전 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 공급자 저장소 이해

ADC에 첫 번째 Terraform 구성 가져오기

ADC용 Terraform 리소스 파일을 작성하는 방법

ADC에서 SSL 오프로딩 사용 사례 설정

Citrix ADC의 영구 저장소에 변경 사항 커밋

Terraform에서 ADC 구성 드리프트 관리

ADC 구성을 Terraform 리소스 파일로 가져오기

Terraform을 사용한 ADC 자동화에 대한 고급 가이드

Terraform을 사용하여 AWS에 ADC 배포

Terraform 작업공간을 활용하여 여러 ADC 관리

Consul-Terraform-Sync를 사용하여 서비스를 동적으로 업데이트합니다.

Citrix ADC 및 Azure Pipelines를 사용한 블루-그린 배포

Terraform `Citrix ADC` 제공자

일회성 작업에 `remote-exec` 사용