En este instructivo, se muestra cómo importar recursos de Google Cloud a una implementación de Infrastructure Manager. Solo puedes importar recursos que se aprovisionaron con Terraform.
Si tienes una configuración de Terraform y aún no la implementaste en Google Cloud, consulta cómo implementar la infraestructura con el Administrador de infraestructura.
Este instructivo comienza con la implementación de una nube privada virtual (VPC) enGoogle Cloud con la CLI de Terraform. Luego, en este instructivo, se muestra cómo importar estos recursos implementados a Infrastructure Manager para que se puedan administrar como una implementación de Infrastructure Manager.
Puedes usar el ejemplo de este instructivo para comprender cómo importar otros recursos deGoogle Cloud a Infra Manager. Para importar la implementación en Infra Manager, la configuración de Terraform que se usa para aprovisionar los recursos debe cumplir con las restricciones, y los recursos deben haberse aprovisionado con una versión de Terraform compatible.
Costos
En este instructivo, se usan los siguientes componentes facturables de Google Cloud:
Antes de comenzar
-
Sign in to your Google Account.
If you don't already have one, sign up for a new account.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Infrastructure Manager API:
gcloud services enable config.googleapis.com
-
Set up authentication:
-
Create the service account:
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
Replace
SERVICE_ACCOUNT_NAME
with a name for the service account. -
Grant the
roles/config.agent
IAM role to the service account:gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/config.agent
Replace the following:
SERVICE_ACCOUNT_NAME
: the name of the service accountPROJECT_ID
: the project ID where you created the service account
-
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Infrastructure Manager API:
gcloud services enable config.googleapis.com
-
Set up authentication:
-
Create the service account:
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
Replace
SERVICE_ACCOUNT_NAME
with a name for the service account. -
Grant the
roles/config.agent
IAM role to the service account:gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/config.agent
Replace the following:
SERVICE_ACCOUNT_NAME
: the name of the service accountPROJECT_ID
: the project ID where you created the service account
-
- Instala una versión compatible de Terraform.
Implementa recursos en Google Cloud
El Google Cloud recurso que implementarás en este instructivo es una VPC. En esta sección, se muestra cómo implementar el recurso para usarlo como ejemplo para importar recursos implementados en Infra Manager.
En este instructivo, se usa la región us-central1
. Si quieres usar otra región, puedes usar cualquiera de las ubicaciones en las que se ejecuta Infra Manager. Consulta Ubicaciones de Infrastructure Manager para obtener la lista de ubicaciones válidas.
Otorga permisos para los recursos en la configuración
Otorgaste los permisos necesarios para ejecutar Infra Manager, pero también debes otorgar permisos específicos para los recursos descritos en la configuración que implementarás.
Otorga permisos para poder crear la red de VPC, que es el recurso definido en la configuración de Terraform:
gcloud projects add-iam-policy-binding PROJECT_ID \
--member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
--role=roles/compute.networkAdmin
Reemplaza lo siguiente:
- SERVICE_ACCOUNT_NAME: Es el nombre de la cuenta de servicio.
- PROJECT_ID: el ID de tu proyecto
Implementa recursos con la CLI de Terraform
Crea una red de VPC con la siguiente configuración de Terraform. Para hacerlo, ejecuta el comando siguiente:
mkdir vpc_to_import cd vpc_to_import cat <<EOF > main.tf variable "project_id" { type = string } resource "google_compute_network" "vpc_network" { name = "my-custom-mode-network" project = var.project_id } EOF
Implementa la configuración con la CLI de Terraform con el siguiente comando:
terraform init echo "************** TERRAFORM APPLY ******************" terraform apply -var="project_id=PROJECT_ID" -auto-approve cd ..
Cuando se aprovisiona la VPC, verás un resultado que comienza con el texto Creation complete
.
El VPC que se define en la configuración de Terraform ahora se implementa en Google Cloud. Terraform crea un archivo de estado, que se encuentra en el sistema de archivos junto al archivo main.tf
.
Crea una implementación de marcador de posición en Infrastructure Manager
Para importar recursos a Infra Manager, necesitas una implementación existente en Infra Manager.
En este instructivo, se usa un bucket de almacenamiento para almacenar la configuración de Terraform. Si estás usando este instructivo para comprender cómo importar otras implementaciones a Infra Manager, puedes almacenar la configuración de Terraform en un bucket de almacenamiento, un repositorio público de Git o en tu máquina local.
Agrega una configuración vacía de Terraform al bucket de almacenamiento:
gcloud storage buckets create gs://import-deployment-configuration --project=PROJECT_ID mkdir placeholder_deployment cd placeholder_deployment cat <<EOF > main.tf EOF gcloud storage cp main.tf gs://import-deployment-configuration cd ..
Crea una implementación con Infra Manager.
gcloud infra-manager deployments apply projects/PROJECT_ID/locations/us-central1/deployments/import-deployment \ --gcs-source gs://import-deployment-configuration \ --input-values project_id=PROJECT_ID \ --service-account projects/PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT
Cuando se complete la implementación, verás lo siguiente:
Creating the deployment...done
Ahora tienes una implementación de Infra Manager. A continuación, debes agregar el archivo de estado y la configuración de Terraform a esta implementación para que esta administre la VPC.
Importa el archivo de estado y la configuración de Terraform
Para administrar el recurso implementado (el VPC) con Infra Manager, debes agregar el archivo de estado y la configuración de Terraform a Infra Manager.
Bloquea la implementación
Bloquea la implementación de Infra Manager para poder realizar cambios en su estado.
LOCK_ID=$(gcloud infra-manager deployments lock projects/PROJECT_ID/locations/us-central1/deployments/import-deployment --format="get(lockId)")
Importa el archivo de estado de Terraform a Infra Manager
Importa el archivo de estado de tus recursos implementados. Terraform creó este archivo de estado cuando implementaste la VPC con la CLI de Terraform.
Sube el archivo de estado de Terraform a la implementación de Infra Manager.
SIGNED_STATE_UPLOAD_URL=$(gcloud infra-manager deployments import-statefile projects/PROJECT_ID/locations/us-central1/deployments/import-deployment --lock-id ${LOCK_ID} --format="get(signedUri)")
cd vpc_to_import
curl -s -X PUT --upload-file terraform.tfstate $SIGNED_STATE_UPLOAD_URL
Sube la configuración de Terraform al bucket de Cloud Storage
Ahora que subiste el archivo de estado de Terraform, también debes subir la configuración de Terraform que usaste para crear la red de VPC. Infra Manager necesita el archivo de estado de Terraform para que, cuando se ejecute una vista previa de Infra Manager, no encuentre ningún cambio en los recursos.
Sube la configuración de Terraform a Cloud Storage con el siguiente comando:
gcloud storage cp main.tf gs://import-deployment-configuration
Desbloquea la implementación
Si usas este instructivo para comprender cómo importar recursos a Infra Manager, asegúrate de que el archivo de estado y la configuración de Terraform no tengan diferencias. Si hay diferencias entre el archivo de estado y la configuración de Terraform, asegúrate de que el archivo de estado describa los recursos que deseas implementar. Cuando desbloquees la implementación, si hay diferencias entre el archivo de estado y la configuración de Terraform, Infra Manager creará o borrará recursos para que coincidan con el archivo de estado.
Debes desbloquear la implementación para poder administrar los recursos con Infra Manager. En este instructivo, el archivo de estado y la configuración de Terraform describen la misma configuración, por lo que Infra Manager no crea ni borra ningún recurso.
Ejecuta el siguiente comando para liberar el bloqueo de la implementación.
gcloud infra-manager deployments unlock projects/PROJECT_ID/locations/us-central1/deployments/import-deployment \
--project PROJECT_ID \
--location us-central1 \
--lock-id ${LOCK_ID}
Ahora que el archivo de estado y la configuración de Terraform se agregaron a tu implementación de Infra Manager, terminaste de importar los recursos implementados. Ahora, Infra Manager administra la VPC implementada.
Obtén una vista previa de los cambios en los recursos
Ejecuta una vista previa de la implementación para confirmar que el estado de Terraform y los recursos implementados en Google Cloud estén sincronizados.
Crea una vista previa con el siguiente comando:
gcloud infra-manager previews create projects/PROJECT_ID/locations/us-central1/previews/import-deployment-preview \ --gcs-source gs://import-deployment-configuration \ --input-values project_id=PROJECT_ID \ --deployment projects/PROJECT_ID/locations/us-central1/deployments/import-deployment \ --service-account projects/PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Obtén detalles de la vista previa para asegurarte de que se haya completado correctamente.
gcloud infra-manager previews describe projects/PROJECT_ID/locations/us-central1/previews/import-deployment-preview
Exporta la vista previa para revisar los cambios.
SIGNED_BIN_PLAN_URL=$(gcloud infra-manager previews export projects/PROJECT_ID/locations/us-central1/previews/import-deployment-preview --format "get(result.binarySignedUri)") curl -X GET --output tfplan.out $SIGNED_BIN_PLAN_URL
Asegúrate de que la configuración esté presente de forma local y se haya inicializado con el siguiente comando:
terraform init
Ejecuta Terraform show para revisar los cambios entre el estado de la implementación de Infrastructure Manager y la configuración.
terraform show tfplan.out
Si el recurso de VPC en Google Cloud y el archivo de estado están sincronizados, terraform show
muestra lo siguiente para validar que el Administrador de infraestructura no ve ningún cambio entre el estado de la implementación y la configuración. Verás un resultado similar al siguiente:
No changes. Your infrastructure matches the configuration.
Terraform has compared your real infrastructure against your configuration and found no differences, so no changes are needed.
Ya importaste los recursos implementados para que los administre Infra Manager. Por ejemplo, ahora puedes usar Infra Manager para actualizar la implementación.
También puedes actualizar la implementación para validar que se haya importado correctamente a Infra Manager.
Limpia
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados en este instructivo, borra el proyecto que contiene los recursos o conserva el proyecto y borra los recursos individuales.
Borra el proyecto
Delete a Google Cloud project:
gcloud projects delete PROJECT_ID
Borra los recursos individuales
Borra la VPC y los metadatos de la implementación:
gcloud infra-manager deployments delete projects/PROJECT_ID/locations/us-central1/deployments/quickstart-deployment
¿Qué sigue?
- Obtén más información sobre Terraform con Google Cloud.
- Actualiza una implementación.
- Consulta el estado de una implementación.
- Ver los recursos implementados.
- Borra una implementación.