Implementar aplicaciones

Después de crear un borrador de aplicación a partir de una plantilla, puedes implementar la aplicación. 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:

• Obtener una vista previa de los cambios que Terraform planea realizar en tu infraestructura
• Habilitar las APIs de recursos que son necesarias para tu aplicación Google Cloud
• Investigar problemas de implementación
• Usar datos de telemetría para analizar el rendimiento de los recursos
• Identificar y aplicar revisiones de plantillas a tu aplicación

Este documento te ayuda a 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 Asigna roles a tu cuenta de servicio)
• El rol Administrador de IAM del proyecto (roles/resourcemanager.projectIamAdmin) en la carpeta habilitada para apps. (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, Google Cloud se crean recursos y comienzas a incurrir en cargos asociados con 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 TEST, DEVELOPMENT, o STAGING entorno.

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 Asigna roles a tu cuenta de servicio.

   • Crea una cuenta de servicio nueva: Debes tener el rol 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 copia en el portapapeles.

   3. Para guardar la vista previa, pégala y guárdala en un documento de tu elección.

8. En el área Revisar APIs, revisa la lista de APIs que son necesarias para 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 de la compilación.

    4. Para ver sugerencias para corregir errores de implementación, haz clic en Solucionar problemas de implementación (vista previa).

       Para obtener más información, consulta Soluciona problemas de implementación.

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

11. Para administrar tu aplicación implementada, consulta Visualiza 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 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 la cuenta de servicio.
     • Para usar tu propia cuenta de servicio, proporciona el nombre completo del recurso 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. Realiza 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 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 la cuenta de servicio.
     • Para usar tu propia cuenta de servicio, proporciona el nombre completo del recurso 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.

Soluciona problemas de implementación

Vista previa

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Si falla la implementación de tu aplicación, puedes ver un resumen de los errores, obtener un análisis detallado, identificar los pasos para resolverlos y corregir automáticamente algunos problemas.

Para solucionar problemas y corregir errores, haz lo siguiente:

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

2. Para analizar errores y sugerir correcciones, haz clic en Solucionar problemas de implementación.

   En el panel Detalles de la solución de problemas , se muestran sugerencias de documentación, cambios de configuración y otra información que puede ayudarte a resolver errores de implementación.

3. Revisa los errores y las recomendaciones de implementación:

   1. Si el análisis genera recomendaciones de configuración de componentes, revisa los cambios sugeridos y haz clic en Actualizar aplicación para aplicar los cambios.

   2. Si el análisis genera otras recomendaciones, el sistema muestra comandos de gcloud CLI que puedes ejecutar para resolver los errores. Para ejecutar los comandos de gcloud CLI en Cloud Shell, haz clic en Ejecutar comando.

Visualiza los detalles de la aplicación

Cuando finaliza la implementación de tu aplicación, puedes 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 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 Supervisa 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 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 las aplicaciones implementadas

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

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

Aplica revisiones de plantillas

Si tu aplicación se implementó anteriormente con App Design Center y un administrador compartió una revisión de plantilla contigo, puedes aplicar los cambios de 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 Visualiza implementaciones.

Para aplicar revisiones de plantillas a tu aplicación, haz lo siguiente:

Precaución: Si modificaste los componentes de una aplicación fuera de App Design Center, esos cambios no se conservarán cuando vuelvas a realizar la implementación. Para conservar los cambios, consulta Modifica las 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 la 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 las configuraciones 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 la aplicación que es la base de 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 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 la 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.