Implementar aplicaciones

Después de crear un borrador de la aplicación a partir de una plantilla, puedes implementarla. Cuando implementas una aplicación con App Design Center, esta se registra automáticamente en App Hub. El proceso de implementación te permite hacer lo siguiente:

• Obtén una vista previa de los cambios que Terraform planea realizar en tu infraestructura.
• Habilita las APIs de recursos Google Cloud que requiere tu aplicación.
• Investigar problemas de implementación
• Usa datos de telemetría para analizar el rendimiento de los recursos.
• Identificar y aplicar revisiones de plantillas a tu aplicación

En este documento, se explica cómo implementar, administrar y aplicar una revisión de plantilla a tu aplicación.

Antes de comenzar

Debes tener uno de los siguientes roles en la carpeta habilitada para la app o en el proyecto de administración:

• Administrador de aplicaciones (roles/designcenter.applicationAdmin)
• Operador de aplicaciones (roles/designcenter.applicationOperator)

Para implementar la aplicación con una cuenta de servicio, debes tener una de las siguientes opciones:

• Tu propia cuenta de servicio que configuraste para implementar aplicaciones y recursos subyacentes. Para obtener más información, consulta Otorga roles a tu cuenta de servicio.
• El rol de administrador de IAM del proyecto (roles/resourcemanager.projectIamAdmin) en la carpeta habilitada para la app Este rol te permite crear una cuenta de servicio nueva durante la implementación.

Implementa tu aplicación

Selecciona una opción de cuenta de servicio y, luego, implementa tu aplicación. Cuando implementas una aplicación, se crean recursos de Google Cloud y comienzas a incurrir en cargos asociados a esos recursos.

Lienzo de diseño

1. En el menú de navegación, haz clic en Aplicaciones.

   Ir a Aplicaciones

2. En la tabla, haz clic en el Nombre de la aplicación.

3. En la página Detalles de la aplicación, revisa los detalles y haz clic en Editar para realizar cambios.

   Nota: Si planeas implementar y, luego, borrar esta aplicación, haz la implementación en el entorno TEST, DEVELOPMENT o STAGING.

4. Haz clic en Implementar.

5. Selecciona una de las siguientes cuentas de servicio para implementar tu aplicación:

   • Selecciona una cuenta de servicio: En el campo Cuenta de servicio, ingresa el nombre de una cuenta de servicio existente. Para configurar la cuenta de servicio, consulta Cómo otorgar roles a tu cuenta de servicio.

   • Crea una cuenta de servicio nueva: Debes tener el rol de administrador de IAM del proyecto (roles/resourcemanager.projectIamAdmin), que se usa para asignar los roles de implementación necesarios a la cuenta de servicio.

6. Haz clic en Continuar.

7. Para obtener una vista previa de los cambios que Terraform planea realizar en tu infraestructura, haz lo siguiente:

   1. Haz clic en Vista previa.

   2. Revisa los cambios y haz clic en Copiar y cerrar. La vista previa se copiará en el portapapeles.

   3. Para guardar la vista previa, pégala y guárdala en el documento que elijas.

8. En el área Revisar APIs, revisa la lista de APIs que requiere tu aplicación. Las APIs se habilitan automáticamente cuando realizas la implementación.

9. Haz clic en Implementar. Los detalles de la aplicación y el estado de la implementación se muestran a medida que se completa la implementación.

10. Si hay problemas con tu implementación, haz lo siguiente:

    1. En el panel Detalles de la aplicación, haz clic en Implementaciones.

    2. Revisa los mensajes de error.

    3. Haz clic en Ver registros para ver información detallada sobre la compilación.

    Sugerencia: Para ver una lista de las aplicaciones con problemas de implementación en Cloud Hub, consulta Ver implementaciones.

11. Para administrar tu aplicación implementada, consulta Cómo ver los detalles de la aplicación.

gcloud CLI

1. Obtén una vista previa de la aplicación para ver el código de Terraform antes de la implementación. Esta operación puede tardar varios minutos en completarse. Realiza una de las siguientes acciones:

   • Para crear automáticamente una cuenta de servicio, usa el siguiente comando:

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --create-sa \
     --service-account=SERVICE_ACCOUNT
     

   • Para usar tu propia cuenta de servicio, usa el siguiente comando:

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --service-account=SERVICE_ACCOUNT
     

   Reemplaza lo siguiente:

   • APPLICATION: Es el ID de la aplicación.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la aplicación.
   • SPACE: Es el ID de tu espacio.
   • SERVICE_ACCOUNT: Realiza una de las siguientes acciones:
     • Para crear una cuenta de servicio nueva, proporciona un nombre para ella.
     • Para usar tu propia cuenta de servicio, proporciona el nombre de recurso completo en el formato projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

   Para obtener más información, consulta gcloud design-center spaces applications preview.

2. Implementa la aplicación de forma asíncrona y copia el nombre completo de la operación. Realice una de las siguientes acciones:

   Nota: Para actualizar una aplicación existente, agrega la marca --replace a los siguientes comandos de implementación.

   • Para crear automáticamente una cuenta de servicio, usa el siguiente comando:

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --create-sa \
      --service-account=SERVICE_ACCOUNT \
      --async
     

   • Para usar tu propia cuenta de servicio, usa el siguiente comando:

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --service-account=SERVICE_ACCOUNT \
      --async
     

   Reemplaza lo siguiente:

   • APPLICATION: Es el ID de la aplicación.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la aplicación.
   • SPACE: Es el ID de tu espacio.
   • SERVICE_ACCOUNT: Realiza una de las siguientes acciones:
     • Para crear una cuenta de servicio nueva, proporciona un nombre para ella.
     • Para usar tu propia cuenta de servicio, proporciona el nombre de recurso completo en el formato projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

   Para obtener más información, consulta gcloud design-center spaces applications deploy.

3. La implementación tarda unos minutos en completarse. Haz un seguimiento del estado de la implementación.

   gcloud design-center operations describe OPERATION\
   --project=PROJECT \
   --location=LOCATION
   

   Reemplaza lo siguiente:

   • OPERATION: Es el nombre completo de la operación copiado del resultado del comando deploy en el formato projects/PROJECT/locations/LOCATION/operations/operation-<var>OPERATION_ID</var>.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la aplicación.

   Para obtener más información, consulta gcloud design-center operations describe.

Ver detalles de la solicitud

Cuando finalice la implementación de la aplicación, podrás examinar la información relacionada. Por ejemplo, puedes ver lo siguiente:

• Detalles como la hora de la última actualización, la fecha de revisión y la región
• Resultados como el URI de servicio
• Estado de la Deployment, información de errores y vínculos a los registros.

Para ver los detalles de la aplicación, haz lo siguiente:

Lienzo de diseño

1. En el menú de navegación, haz clic en Aplicaciones.

   Ir a Aplicaciones

2. En la tabla, haz clic en el Nombre de la aplicación. En el panel Detalles de la aplicación, se muestra lo siguiente:

   • Ver la app en App Hub: Investiga tu aplicación en App Hub. Puedes ver los recursos implementados y examinar los datos de telemetría para diagnosticar problemas y analizar el rendimiento. Para obtener más información, consulta Cómo supervisar las aplicaciones de App Hub.

   • Detalles de la app: Consulta información como la fecha de la última actualización, la plantilla de origen, la región y la cuenta de servicio.

   • Resultados: Identifica los URIs de servicio, que puedes usar para interactuar con el frontend o el backend de tu aplicación.

   • Implementaciones: Examina el estado de la implementación, los errores de implementación y los vínculos a los registros para solucionar problemas.

gcloud CLI

gcloud design-center spaces applications describe APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

Reemplaza lo siguiente:

• APPLICATION: Es el ID de la aplicación.
• PROJECT: Es el ID de tu proyecto de administración.
• LOCATION: Es la región de la aplicación.
• SPACE: Es el ID de tu espacio.

Para obtener más información, consulta gcloud design-center spaces applications describe.

Modifica aplicaciones implementadas

Si deseas modificar una aplicación implementada, realiza una de las siguientes acciones para asegurarte de que los cambios se conserven cuando vuelvas a implementar la aplicación:

• Revisa la plantilla y, luego, aplica la revisión de la plantilla
• Revisa la aplicación

Cómo aplicar revisiones de plantillas

Si tu aplicación se implementó anteriormente con el Centro de diseño de aplicaciones y un administrador compartió una revisión de la plantilla contigo, puedes aplicar los cambios de la plantilla a tu aplicación. Cuando actualizas tu aplicación, se crea una revisión de la aplicación. Puedes configurar los componentes que se modificaron o agregaron a la plantilla revisada.

Puedes ver las revisiones de plantillas disponibles para tus aplicaciones con Cloud Hub. Para obtener más información, consulta Cómo ver implementaciones.

Para aplicar las revisiones de la plantilla a tu solicitud, haz lo siguiente:

Precaución: Si modificaste los componentes de una aplicación fuera del Centro de diseño de aplicaciones, esos cambios no se conservarán cuando vuelvas a implementar la aplicación. Para conservar los cambios, consulta Cómo modificar aplicaciones implementadas.

Lienzo de diseño

1. En el menú de navegación, haz clic en Plantillas.

   Ir a Plantillas

2. Haz clic en el ID de plantilla que contiene la revisión que deseas aplicar.

3. En la lista Configurar una app, selecciona la aplicación que deseas actualizar.

4. Edita los detalles de la aplicación y haz clic en Guardar.

5. Haz clic en cada componente del lienzo de diseño y modifica la configuración de los componentes.

6. Haz clic en Implementar. Para conocer los pasos de implementación, consulta Implementa tu aplicación.

gcloud CLI

1. Identifica el URI de revisión de la plantilla de la aplicación para la revisión más reciente.

    gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --format='yaml(name,latestRevision)'
   

   Reemplaza lo siguiente:

   • APPLICATION_TEMPLATE: Es el ID de la plantilla de aplicación que sirve como base para tu aplicación.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la plantilla de la aplicación.
   • SPACE: Es el ID de tu espacio.

   Para obtener más información, consulta gcloud design-center spaces application-templates describe.

2. Copia el resultado de latestRevision.

3. Actualiza la aplicación para usar la revisión de la plantilla de la aplicación.

    gcloud design-center spaces applications update APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION
   

   Reemplaza lo siguiente:

   • APPLICATION: Es el ID de la aplicación.
   • PROJECT: Es el ID de tu proyecto de administración.
   • LOCATION: Es la región de la aplicación.
   • SPACE: Es el ID de tu espacio.
   • SOURCE_APPLICATION_TEMPLATE_REVISION: Es el URI de la plantilla de tu aplicación. Por ejemplo, projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION

   Para obtener más información, consulta gcloud design-center spaces applications update.

4. Para configurar componentes nuevos o actualizados en la aplicación, consulta Configura componentes y conexiones.

5. Cuando implementes la aplicación, usa la marca --replace. Para conocer los pasos de implementación, consulta Implementa tu aplicación.