Emite un certificado con Terraform
Aprende a usar Terraform con el Certificate Authority Service para hacer lo siguiente:
- Crea un grupo de autoridades certificadoras (AC).
- Crea una AC en el nuevo grupo de AC.
- Genera una nueva solicitud de firma de certificado (CSR).
- Usa la CSR generada para solicitar un certificado del nuevo grupo de AC.
Terraform es un software de código abierto que te permite crear y administrar tus recursos de AC mediante su paradigma de infraestructura como código. En esta guía de inicio rápido, se usa el Proveedor de Terraform de Google Cloud para Terraform.
Para seguir la guía paso a paso en esta tarea directamente en la consola de Google Cloud, haz clic en Guiarme:
Antes de comenzar
Asegúrate de tener el rol de IAM de administrador de servicios de AC (roles/privateca.admin
). Si no tienes este rol de IAM, consulta Otorga un solo rol para obtener información sobre cómo otorgarlo.
Crea un proyecto de Google Cloud
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the CA Service API.
Instala Google Cloud CLI
Si aún no lo hiciste, instala Google Cloud CLI. Cuando se te solicite, elige el proyecto que seleccionaste o creaste antes.
Si ya tienes instalada la Google Cloud CLI, ejecuta el siguiente comando gcloud components update
para actualizarla:
gcloud components update
Muestra de configuración de Terraform
Ejecuta el archivo de configuración de Terraform
Para aplicar tu configuración de Terraform en un proyecto de Google Cloud, completa los pasos de las siguientes secciones.
Prepara Cloud Shell
- Inicia Cloud Shell
-
Establece el proyecto de Google Cloud predeterminado en el que deseas aplicar tus configuraciones de Terraform.
Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.
export GOOGLE_CLOUD_PROJECT=
PROJECT_ID Las variables de entorno se anulan si configuras valores explícitos en el archivo de configuración de Terraform.
Prepara el directorio
Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz).
-
En Cloud Shell, crea un directorio y un archivo nuevo dentro de ese directorio. El nombre del archivo debe tener la extensión
.tf
, por ejemplo,main.tf
. En este instructivo, el archivo se denominamain.tf
.mkdir
DIRECTORY && cdDIRECTORY && touch main.tf -
Si sigues un instructivo, puedes copiar el código de muestra en cada sección o paso.
Copia el código de muestra en el
main.tf
recién creado.De manera opcional, copia el código de GitHub. Esto se recomienda cuando el fragmento de Terraform es parte de una solución de extremo a extremo.
- Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
- Guarda los cambios.
-
Inicializa Terraform. Solo debes hacerlo una vez por directorio.
terraform init
De manera opcional, incluye la opción
-upgrade
para usar la última versión del proveedor de Google:terraform init -upgrade
Aplica los cambios
-
Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas:
terraform plan
Corrige la configuración según sea necesario.
-
Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, escribe
yes
cuando se te solicite:terraform apply
Espera hasta que Terraform muestre el mensaje “¡Aplicación completa!”.
- Abre tu proyecto de Google Cloud para ver los resultados. En la consola de Google Cloud, navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.
Realiza una limpieza
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta guía de inicio rápido, borra el grupo de AC y todos los recursos definidos en el archivo de configuración de Terraform:
terraform destroy
Cuando se te solicite, ingresa yes
.
Si creaste un proyecto nuevo para esta guía de inicio rápido y ya no lo necesitas, bórralo.
¿Qué sigue?
- Obtén más información para ejecutar comandos
gcloud
con Cloud Shell. - Obtén más información para usar Terraform con Google Cloud.
- Obtén más información para usar Terraform con el servicio de AC.
- Lee la documentación de Terraform sobre la compatibilidad con el servicio de AC.
- Comienza a usar el proveedor de Google Cloud.