Descarga terraform provider citrixadc - Descarga del código fuente terraform provider citrixadc

terraform provider citrixadc

Otro código fuente

v1.42.0

Descargar

Proveedor Terraform `Citrix ADC`

Citrix ha desarrollado un proveedor Terraform personalizado para automatizar implementaciones y configuraciones de Citrix ADC. Con Terraform, puede configurar de forma personalizada sus ADC para diferentes casos de uso, como equilibrio de carga, SSL, cambio de contenido, GSLB, WAF, etc.

Obtenga más información sobre la automatización Citrix ADC aquí

Para implementar Citrix ADC en la nube pública: AWS y Azure, consulte los scripts de la nube en el repositorio de github terraform-cloud-scripts.

✉️ Para cualquier problema inmediato o ayuda, comuníquese con nosotros en [email protected].

Ejemplos y módulos

Consulte ejemplos
Consulte también golden_templates

Documentación del proveedor de Terraform

¿Por qué Terraform para Citrix ADC?
Navegando por el repositorio
Comprender la configuración del proveedor
Comprender la configuración de recursos
Directrices generales sobre configuraciones de ADC
Confirmación de cambios en el almacén persistente de Citrix ADC
Lista de casos de uso de ADC compatibles con Terraform
Uso de remote-exec para tareas únicas

Guía para principiantes para automatizar ADC con Terraform

Laboratorio práctico con automatización ADC con Terraform
Instale Terraform en su propia configuración
Comprender el repositorio del proveedor de terraforma ADC)
Obtenga su primera configuración de terraform en ADC
Cómo escribir un archivo de recursos de Terraform para ADC
Configurar el caso de uso de descarga SSL en ADC
Confirmación de cambios en el almacén persistente de Citrix ADC
La gestión de las configuraciones de ADC se desvía en terraform
Importación de configuraciones de ADC al archivo de recursos de Terraform

Guía avanzada sobre la automatización de ADC con Terraform

Implemente ADC en AWS usando Terraform
Aprovechar los espacios de trabajo de Terraform para gestionar múltiples ADC
Actualiza dinámicamente los servicios usando Consul-Terraform-Sync
Implementación azul-verde con Citrix ADC y Azure Pipelines

¿Por qué Terraform para Citrix ADC?

Terraform es una infraestructura de código abierto como herramienta de software de código que proporciona un flujo de trabajo CLI consistente para administrar cientos de servicios en la nube. Terraform codifica las API de la nube en archivos de configuración declarativos. Terraform se puede utilizar para implementar y configurar ADC. Configurar Citrix ADC a través de Terraform proporciona múltiples beneficios.

Enfoque de infraestructura como código para ADC: puede almacenar las configuraciones de ADC en herramientas scm como GitHub y la versión y realizar un seguimiento como cualquier otro repositorio de código que tenga.
Enfoque declarativo para la automatización de ADC: los usuarios solo necesitan definir el estado objetivo de ADC. Los recursos de terraform de ADC realizarán las llamadas API apropiadas para lograr el estado objetivo.
Los archivos de recursos ADC en Terraform son amigables para los humanos y fáciles de entender.
Resuma la complejidad asociada con la arquitectura interna de Citrix ADC.
Detecte fácilmente las desviaciones de configuración en ADC a través de Terraform.

Navegando por el repositorio

Carpeta citrixadc : contiene toda la biblioteca de recursos de ADC que admitimos a través de Terraform. Estas bibliotecas de recursos llamarán internamente a NITRO APIS para configurar el ADC de destino.
Carpeta examples : contiene ejemplos para que los usuarios utilicen varios recursos de ADC, por ejemplo, la carpeta simple_lb contiene el archivo resources.tf que ilustra cómo se puede utilizar el recurso citrixadc_lbvserver para crear un servidor virtual de equilibrio de carga en el ADC de destino. De manera similar, diferentes carpetas contienen ejemplos sobre cómo definir diferentes recursos. Se espera que los usuarios revisen estos ejemplos y definan las configuraciones de ADC que deseen.
Carpeta docs : https://github.com/citrix/terraform-provider-citrixadc/tree/master/docs/resources: contiene la documentación de todas las configuraciones de recursos admitidas a través de Terraform. Consulte esto para comprender los diferentes argumentos y valores que toma un recurso en particular.

Comprender la configuración del proveedor

provider.tf contiene la información sobre el ADC de destino donde desea aplicar la configuración.

 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.
}

Podemos usar una URL https y aceptar el certificado de autoridad que no es de confianza en Citrix ADC especificando insecure_skip_verify = true

Para usar https sin la necesidad de configurar insecure_skip_verify = true siga esta guía sobre cómo reemplazar el certificado TLS predeterminado por uno de una autoridad certificadora confiable.

Se prefiere el uso de https . El uso de http dará como resultado que todas las variables de configuración del proveedor, así como las variables de recursos, se transmitan en texto sin cifrar. Cualquiera que observe el flujo de datos HTTP podrá analizar valores confidenciales, como la contraseña del proveedor.

Evite almacenar las credenciales del proveedor en el estado local mediante el uso de un backend que admita el cifrado. También se recomienda el proveedor de bóveda hasicorp para almacenar datos confidenciales.

También puede utilizar variables de entorno como se indica en los comentarios anteriores.

Se apoyan los siguientes argumentos.

username : este es el nombre de usuario para acceder a Citrix ADC. El valor predeterminado es nsroot a menos que se haya configurado la variable de entorno NS_LOGIN
password : esta es la contraseña para acceder a Citrix ADC. El valor predeterminado es nsroot a menos que se haya configurado la variable de entorno NS_PASSWORD
endpoint : (obligatorio) punto final de la API de Nitro con el formato http://<NS_IP>/ o http://<NS_IP>:<PORT>/ . Se puede especificar en la variable de entorno NS_URL

insecure_skip_verify : (opcional, verdadero/falso) si se acepta el certificado que no es de confianza en Citrix ADC cuando el punto final de Citrix ADC es https

proxied_ns : (opcional, NSIP) El Citrix ADC NSIP de destino para llamadas proxy MAS. Cuando se define esta opción, username , password y endpoint deben hacer referencia al proxy MAS.

El nombre de usuario, la contraseña y el punto final se pueden proporcionar en las variables de entorno NS_LOGIN , NS_PASSWORD y NS_URL .

Configuración de recursos

Resources.tf contiene el estado deseado de los recursos que desea en el ADC de destino. Por ejemplo, para crear un servidor virtual de equilibrio de carga en ADC, el siguiente recurso.tf contiene las configuraciones deseadas de 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 "
}

Para comprender los argumentos, los valores posibles y otros argumentos disponibles para un recurso determinado, consulte la documentación de la API de NITRO https://developer-docs.citrix.com/projects/netscaler-nitro-api/en/12.0/configuration/ load-balancing/lbvserver/lbvserver/ y la documentación de Terraform como https://github.com/citrix/terraform-provider-citrixadc/blob/master/docs/resources/lbvserver.md.

el state del atributo no está sincronizado con el objeto remoto. Si el estado del lb vserver no está sincronizado con la configuración de terraform, deberá corromper manualmente el recurso y aplicar la configuración nuevamente.

Directrices generales sobre la configuración de ADC

Las subcarpetas de la carpeta de ejemplo contienen ejemplos de diferentes configuraciones de ADC a través de terraform. Consulte el ejemplo de simple_lb para comprender la estructura y el uso a continuación.

Estructura

resources.tf describe los objetos de configuración reales de NetScaler que se crearán. Los atributos de estos recursos están codificados o se buscan a partir de variables de entrada en terraform.tfvars
variables.tf describe las variables de entrada a la configuración de terraform. Estos pueden tener valores predeterminados
provider.tf se utiliza para especificar el nombre de usuario, la contraseña y el punto final de NetScaler. Alternativamente, puede configurar las variables de entorno NS_URL, NS_LOGIN y NS_PASSWORD.
terraform.tfvars tiene las entradas variables especificadas en variables.tf

Usando

Modifique terraform.tfvars y provider.tf para adaptarlos a su propia implementación de NetScaler.
Utilice terraform plan y terraform apply para configurar NetScaler.

Actualizando su configuración

Modifique el conjunto de servicios backend y utilice terraform plan y terraform apply para verificar los cambios.

Confirmación de cambios en el almacén persistente de Citrix ADC

El proveedor no enviará los cambios de configuración al almacén persistente de Citrix ADC. Para hacer esto, ejecute el script de shell ns_commit.sh :

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

Para asegurarnos de que la configuración se guarde en cada ejecución, podemos usar algo como terraform apply && ns_commit.sh

Caso de uso de ADC compatible con Terraform

La lista de casos de uso admitidos en ADC se puede encontrar aquí https://registry.terraform.io/providers/citrix/citrixadc/latest/docs.

Uso de `remote-exec` para tareas únicas

Terraform es útil para mantener el estado deseado de un conjunto de recursos. Es menos útil para tareas como la configuración de red que no cambian. La configuración de la red es como usar un aprovisionador dentro de Terraform. El directorio de examples/remote-exec muestra ejemplos de cómo Terraform puede usar ssh para realizar estas tareas únicas.

Guía para principiantes sobre la automatización ADC con Terraform

Laboratorio práctico con automatización ADC con Terraform

Pruebe nuestro laboratorio práctico para experimentar cómo es usar Terraform para ADC.

Instale Terraform en su propia configuración

El primer paso para usar Terraform para ADC es instalar Terraform CLI. Consulte la documentación de Hashicorp para instalar Terraform CLI en su propio entorno.

Comprender el repositorio del proveedor de terraforma ADC

Consulte la sección Navegando por nuestro repositorio.

Obtenga su primera configuración de terraform en ADC

Siga el artículo sobre Introducción a Terraform en NetScaler para obtener su primera configuración.

Cómo escribir un archivo de recursos de Terraform para ADC

Para escribir los recursos de Terraform para Citrix ADC, consulte los siguientes enlaces: documentación de NITRO API o documentación de registro de terraform.

Configurar el caso de uso de descarga SSL en ADC

Aquí está la plantilla de Terraform que debe seguir para configurar la descarga de SSL.

Confirmación de cambios en el almacén persistente de Citrix ADC

Consulte la sección de confirmación de cambios.

La gestión de las configuraciones de ADC se desvía en terraform

Quieres ver el estado actual de las entidades ADC en Terraform

Utilice la actualización de terraform para actualizar su archivo de estado de terraform local para que coincida con el estado de ADC existente
Utilice terraform show para mostrar el estado actual de toda su configuración
Utilice la lista de estados de Terraform para mostrar los recursos que se están rastreando/administrando a través de Terraform
Para inspeccionar una entidad en particular, utilice terraform state show <entity_name>, por ejemplo, terraform state show citrixadc_servicegroup.tf_servicegroup.

Si desea anular la configuración de ADC con las configuraciones que tiene en el archivo de recursos de Terraform, entonces

Puede ejecutar el plan terraform para ver las derivas/diferencias entre los dos estados.
Ejecute terraform apply para enviar las configuraciones deseadas (en su archivo de recursos de Terraform) a su ADC.

Actualice su archivo de estado de Terraform para reflejar el estado actual/verdadero de ADC

Utilice la actualización de terraform para actualizar su archivo de estado de terraform local para que coincida con el estado de ADC existente

Importación de configuraciones de ADC al archivo de recursos de Terraform

Aprenda cómo importar configuraciones de NetScaler existentes a recursos de Terraform aquí

Guía avanzada sobre la automatización de ADC con Terraform

Implemente ADC en AWS usando Terraform

Consulte nuestros scripts de nube de Terraform para AWS y el vídeo de demostración

Aprovechar los espacios de trabajo de Terraform para gestionar múltiples ADC

Por determinar

Actualiza dinámicamente los servicios usando Consul-Terraform-Sync

Nuestra integración Consul-Terraform-Sync permite a los usuarios crear, actualizar y eliminar automáticamente grupos de servicios en Citrix ADC que están sincronizados con el marco Consul Terraform Sync.