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

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. 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 the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

  4. Verify that billing is enabled for your Google Cloud project.

  5. 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.enable permission. 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.

    Enable the APIs

  6. 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 the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

  8. Verify that billing is enabled for your Google Cloud project.

  9. 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.enable permission. 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.

    Enable the APIs

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:

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:

  1. En la consola de Google Cloud , ve a la página Infrastructure Manager.

    Ir a Infrastructure Manager

  2. Haz clic en Crear implementación nueva.

  3. 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:

      1. 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.
      2. En el campo Nombre de la cuenta de servicio, ingresa im-quickstart-sa y, luego, haz clic en Crear y continuar.
      3. 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.

      4. Haz clic en Continuar y, luego, en Listo.

      5. Cierra la pestaña y vuelve a la página Crea una nueva implementación de Terraform.

      6. 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-network

    • Directorio de Git: modules/vpc

  4. Haz clic en Continuar.

  5. 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, ingresa quickstart-vpc. No incluyas comillas.

    Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud .

  6. Haz clic en Crear vista previa.

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

  8. Para crear una implementación que use los valores de la vista previa, haz clic en Crear implementación.

  9. En el campo ID de implementación, ingresa quickstart-deployment.

  10. 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:

  1. En la consola de Google Cloud , ve a la página Infrastructure Manager.

    Ir a Infrastructure Manager

  2. En la columna ID, haz clic en quickstart-deployment.

  3. 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 :

  1. En la consola de Google Cloud , ve a la página Redes de VPC.

    Ir a las 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.

  2. 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:

  1. En la consola de Google Cloud , ve a la página Historial de compilaciones.

    Ir al historial de compilaciones

  2. 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 de quickstart-preview-<var>UUID</var> y la implementación de quickstart-deployment.

  3. 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:

  1. En la consola de Google Cloud , ve a la página Infrastructure Manager.

    Ir a Infrastructure Manager

  2. En la columna ID, haz clic en quickstart-deployment.

  3. En la página de detalles de la implementación, haz clic en Borrar.

  4. En el cuadro de diálogo de confirmación, ingresa quickstart-deployment y, 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:

  1. En la consola de Google Cloud , ve a la página Cuentas de servicio.

    Ir a Cuentas de servicio

  2. Selecciona la casilla de verificación de im-quickstart-sa y, luego, haz clic en Borrar.

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

  1. En la Google Cloud consola, ve a la página Administrar recursos.

    Ir a Administrar recursos

  2. En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.

  3. En el diálogo, ingresa el ID del proyecto y, luego, haz clic en Cerrar.

¿Qué sigue?