Implementa una VPC con Terraform
Puedes implementar una red de nube privada virtual (VPC) con Infrastructure Manager y la consola deGoogle Cloud . Esta guía de inicio rápido está dirigida a administradores de la nube, ingenieros de plataformas y desarrolladores que desean administrar la infraestructura de Google Cloud como código. Una red de VPC proporciona redes aisladas para recursos como instancias de máquina virtual (VM), bases de datos y apps.
Con Infra Manager, defines la red en una configuración de Terraform en lugar de crearla de forma manual. Infra Manager ejecuta Terraform por ti y almacena el estado de Terraform. Como resultado, puedes reproducir, actualizar y borrar tu infraestructura de forma coherente. Para obtener más información, consulta Descripción general de Terraform en Google Cloud.
En esta guía de inicio rápido, obtendrás una vista previa y crearás una implementación a partir de una configuración de Terraform en un repositorio público de GitHub.
Antes de comenzar
-
Accede a tu Cuenta de Google.
Si todavía no tienes una cuenta, regístrate para obtener una nueva.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Infrastructure Manager and Compute Engine APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Infrastructure Manager and Compute Engine APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
Roles obligatorios
Si quieres obtener los permisos que necesitas para completar esta guía de inicio rápido, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:
- Administrador de Cloud Infrastructure Manager (
roles/config.admin) - Administrador de cuenta de servicio (
roles/iam.serviceAccountAdmin) - Usuario de la cuenta de servicio (
roles/iam.serviceAccountUser) - Administrador de IAM de proyecto (
roles/resourcemanager.projectIamAdmin) - Visualizador de la red de Compute (
roles/compute.networkViewer) - Visualizador de Cloud Build (
roles/cloudbuild.builds.viewer) - Visualizador de objetos de Storage (
roles/storage.objectViewer)
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.
Obtén una vista previa y crea una implementación
Cuando creas una implementación, Infra Manager aprovisiona los recursos que se definen en la configuración de Terraform. Antes de crear la implementación, crea una vista previa para verificar qué recursos planea aprovisionar Infra Manager.
Para obtener una vista previa y crear una implementación que aprovisione una red de VPC, haz lo siguiente:
En la consola de Google Cloud , ve a la página Infrastructure Manager.
Haz clic en Crear implementación nueva.
En la página Crea una nueva implementación de Terraform, en la sección Detalles de la implementación, ingresa los siguientes valores:
- ID de implementación:
quickstart-preview - Región:
us-central1 - Versión de Terraform:
1.5.7 Cuenta de servicio: Crea una cuenta de servicio nueva llamada
im-quickstart-sa. Para crear la cuenta de servicio y otorgarle los roles necesarios, haz lo siguiente:- En la lista Cuenta de servicio, haz clic en Nueva cuenta de servicio. La página Crear cuenta de servicio se abre en una pestaña nueva.
- En el campo Nombre de la cuenta de servicio, ingresa
im-quickstart-say, luego, haz clic en Crear y continuar. En la sección Otorga a esta cuenta de servicio acceso al proyecto, usa la lista Selecciona un rol para otorgar los siguientes roles. Para agregar el segundo rol, haz clic en Agregar otro rol.
- Agente de Cloud Infrastructure Manager (
roles/config.agent): permite que Infra Manager ejecute Terraform y almacene el estado y los registros de la implementación. - Administrador de red de Compute (
roles/compute.networkAdmin): Permite que Infra Manager cree y administre la red de VPC.
Para obtener más información sobre los roles de Infra Manager, consulta Control de acceso con IAM.
- Agente de Cloud Infrastructure Manager (
Haz clic en Continuar y, luego, en Listo.
Cierra la pestaña y vuelve a la página Crea una nueva implementación de Terraform.
En la lista Cuenta de servicio, haz clic en Actualizar lista y, luego, selecciona
im-quickstart-sa.
Fuente de la configuración de Terraform: Git
Repositorio de Git:
https://github.com/terraform-google-modules/terraform-google-networkDirectorio de Git:
modules/vpc
- ID de implementación:
Haz clic en Continuar.
En la sección Detalles de Terraform, en Valores de entrada, ingresa los siguientes valores para las variables de módulo prepropagadas:
- En la fila de la clave
project_id, en el campo Valor, ingresa<var>PROJECT_ID</var>. No incluyas comillas. - En la fila de la clave
network_name, en el campo Valor, ingresaquickstart-vpc. No incluyas comillas.
Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud .
- En la fila de la clave
Haz clic en Crear vista previa.
En la página de detalles de la vista previa de
quickstart-preview-<var>UUID</var>, verifica que el valor de la fila Estado sea Correcto.Para crear una implementación que use los valores de la vista previa, haz clic en Crear implementación.
En el campo ID de implementación, ingresa
quickstart-deployment.Haz clic en Crear una implementación.
El Administrador de infraestructura aprovisiona la red de VPC. Cuando se complete la implementación, recibirás una notificación en la consola de Google Cloud .
Creaste una implementación con Infra Manager. En las siguientes secciones, verificarás la implementación, verás la red aprovisionada y revisarás el trabajo de Cloud Build que ejecutó Terraform.
Consulta el estado de la implementación
Después de que el Administrador de infraestructura crea la implementación, puedes ver detalles sobre ella, como su estado, su revisión más reciente y la fuente de su configuración de Terraform.
Para ver los detalles de la implementación, haz lo siguiente:
En la consola de Google Cloud , ve a la página Infrastructure Manager.
En la columna ID, haz clic en
quickstart-deployment.En la página de detalles de la implementación, verifica que el valor de la fila Estado sea Activo.
Visualiza la red de VPC aprovisionada
Para confirmar que Infra Manager aprovisionó la red que define la configuración de Terraform, consulta la red en la consola de Google Cloud :
En la consola de Google Cloud , ve a la página Redes de VPC.
La lista de redes incluye
quickstart-vpc, que es la red que aprovisionó el Administrador de infraestructura. En la lista, se muestran detalles sobre la red, como su modo de creación de subredes, su unidad de transmisión máxima (MTU) y su modo de enrutamiento dinámico.Para ver más detalles sobre la red, como sus subredes, reglas de firewall y rutas, haz clic en
quickstart-vpc.
Visualiza los resultados de la compilación en Cloud Build
Infra Manager usa Cloud Build para ejecutar Terraform en cada revisión de implementación. Para inspeccionar los comandos de Terraform que crearon tu implementación o solucionar problemas de una implementación que falla, consulta los registros de compilación de Cloud Build:
En la consola de Google Cloud , ve a la página Historial de compilaciones.
En la tabla de compilaciones, busca la compilación más reciente con la región
us-central1. En esta lista, aparecen las compilaciones de la vista previa dequickstart-preview-<var>UUID</var>y la implementación dequickstart-deployment.Haz clic en el ID de compilación para abrir la página Detalles de la compilación.
En la página Detalles de la compilación, se muestra el estado de cada paso de la compilación y el registro de compilación, que incluye el resultado de los comandos de Terraform. Si una implementación falla, usa el registro de compilación para identificar la causa. Para obtener más información, consulta Soluciona errores de implementación.
También puedes abrir la compilación de una implementación desde la página de detalles de la implementación en Infra Manager haciendo clic en el vínculo Registros de Cloud Build.
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 la implementación cuando ya no la necesites. Las vistas previas de la Deployment no generan cargos en tu cuenta de Google Cloud . Si deseas borrar la vista previa, consulta Borra vistas previas.
Borrar la implementación
Borra la implementación y la red de VPC aprovisionada:
Para borrar la implementación, haz lo siguiente:
En la consola de Google Cloud , ve a la página Infrastructure Manager.
En la columna ID, haz clic en
quickstart-deployment.En la página de detalles de la implementación, haz clic en Borrar.
En el cuadro de diálogo de confirmación, ingresa
quickstart-deploymenty, luego, haz clic en Confirmar.
Borra la cuenta de servicio
Después de que Infra Manager borre la implementación, borra la
cuenta de servicio im-quickstart-sa para que no conserve sus roles en tu
proyecto:
En la consola de Google Cloud , ve a la página Cuentas de servicio.
Selecciona la casilla de verificación de
im-quickstart-say, luego, haz clic en Borrar.En el cuadro de diálogo, haz clic en Borrar.
Opcional: borra el proyecto
Si creaste la implementación en un proyecto de Google Cloud nuevo y ya no lo necesitas, bórralo.
En la Google Cloud consola, ve a la página Administrar recursos.
En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
En el diálogo, ingresa el ID del proyecto y, luego, haz clic en Cerrar.
¿Qué sigue?
- Obtén más información sobre cómo funciona Infra Manager.
- Obtén más información sobre Terraform y el Administrador de infraestructura.
- Actualiza un objeto Deployment.
- Automatiza las implementaciones.
- Para obtener un conjunto de parámetros de configuración y módulos que estén listos para usarse con Google Cloud, consulta Planos y módulos de Terraform para Google Cloud en la documentación de Terraform en Google Cloud .