Administrar aplicaciones

Crea una aplicación cuando quieras personalizarla y, luego, implementarla a partir de una plantilla. Por ejemplo, puedes crear una aplicación que planeas implementar con fines de prueba. Es posible que crees otra aplicación para el uso en producción.

Cuando creas una aplicación, especificas información que te ayuda a categorizarla según el uso previsto. Esta información te ayuda a filtrar y encontrar una aplicación específica. También puedes configurar componentes y detalles de conexión.

Antes de comenzar

Pídele a tu administrador que te otorgue uno de los siguientes roles en la carpeta habilitada para la app o en el proyecto de administración:

  • Administrador de App Design Center (roles/designcenter.admin)
  • Administrador de aplicaciones (roles/designcenter.applicationAdmin)
  • Editor de aplicaciones (roles/designcenter.applicationEditor)

Crea un borrador de la aplicación

Crea un borrador de aplicación a partir de una plantilla especificando detalles y, de manera opcional, anulando la configuración de los componentes. Luego, puedes implementar el borrador para crear una aplicación.

  1. En el menú de navegación, realiza una de las siguientes acciones:

  2. Haz clic en el ID de plantilla que deseas usar.

  3. En el lienzo de diseño, haz clic en Configurar una app y, luego, en Crear aplicación nueva.

  4. En el área Nombre de la aplicación, haz lo siguiente para nombrar y describir tu aplicación:

    1. En el campo Nombre, ingresa un identificador único en este espacio. Por ejemplo, usa una combinación única de nombre y entorno, como web-app-staging. Este campo es obligatorio.

      Puedes usar hasta 63 caracteres, incluidas letras en minúscula, números y guiones. El nombre debe comenzar con una letra minúscula y no puede terminar con un guion. Los nombres no se pueden cambiar.

    2. En el campo Nombre visible, ingresa un nombre para mostrar en la consola deGoogle Cloud .

    3. En el campo Descripción, ingresa el propósito de esta aplicación.

  5. Para establecer un proyecto predeterminado para cualquier componente con un campo ID del proyecto vacío, selecciona un proyecto de la lista Proyecto de implementación. El proyecto debe cumplir con los siguientes requisitos:

    Si un componente ya tiene un proyecto especificado en su campo ID del proyecto, se usará ese proyecto en lugar de este parámetro de configuración.

  6. En la lista Región, selecciona la región en la que se implementan los componentes. La región del componente se aplica según lo siguiente:

    • Si el alcance de la aplicación es Global (predeterminado), la región se aplica a los componentes que aún no tienen una región configurada.

    • Si el alcance de la aplicación es Regional, la región se aplica a todos los componentes.

  7. En la lista Entorno, selecciona el entorno en el que deseas implementar esta aplicación. Por ejemplo, es posible que desees verificar que tu implementación funcione según lo previsto en TEST.

  8. En la lista Criticidad, selecciona el grado de impacto en tu empresa. Por ejemplo, LOW o HIGH.

  9. Para especificar propietarios, en el área Propietarios, haz clic en Agregar propietario y, luego, ingresa un nombre visible y un correo electrónico para lo siguiente:

    • En el área Propietarios de la empresa, ingresa un propietario que sea responsable de la calidad y las expectativas de los usuarios.

    • En el área Propietarios desarrolladores, ingresa un propietario que sea responsable del desarrollo y la programación.

    • En el área Propietarios del operador, ingresa un propietario que sea responsable de operar la aplicación.

  10. En la lista Alcance, selecciona una de las siguientes opciones:

    • Global (predeterminado): La aplicación contiene un recurso global o los recursos se encuentran en varias regiones.

    • Regional: Todos los recursos están en una sola región.

    Este campo es obligatorio. Para obtener más información, consulta Cómo comparar aplicaciones globales y regionales.

  11. Haz clic en Crear aplicación. Se muestran los detalles de la aplicación.

Configura componentes y conexiones

Para cada componente de la aplicación, puedes especificar detalles de configuración, como el proyecto en el que se crea el recurso y la ubicación en la que se implementa.

También puedes modificar los detalles de la conexión si la configuración predeterminada no cumple con tus requisitos. Por ejemplo, puedes modificar los nombres de las claves de las variable de entorno, cambiar los puertos de conexión o agregar roles adicionales a las cuentas de servicio.

Debes configurar los detalles obligatorios para cada recurso compatible.

Para configurar componentes y conexiones, haz lo siguiente:

  1. En el lienzo de diseño, haz clic en un componente.

  2. En el área Configuración, en la lista ID del proyecto, selecciona el proyecto en el que deseas implementar el recurso. Selecciona un proyecto que cumpla con los siguientes requisitos:

  3. Configura parámetros adicionales para el recurso. Por ejemplo, para Cloud SQL, puedes configurar lo siguiente:

    • Región
    • Configuración de las copias de seguridad
    • Marcas de la base de datos
    • Configuración de IP

    Para obtener vínculos a la documentación de configuración de cada componente, consulta Recursos compatibles.

  4. Cuando conectas componentes en el lienzo de diseño, se usan valores de configuración predeterminados para crear la conexión. Para agregar o modificar los detalles de conexión, haz lo siguiente.

    1. En el lienzo de diseño, haz clic en la conexión entre dos componentes. Se abrirá el panel Connection y se mostrarán los parámetros de conexión.

    2. Realiza una de las siguientes acciones:

      • Para modificar un parámetro de conexión existente, haz clic en Editar.

      • Para agregar un parámetro de conexión nuevo, haz clic en Agregar parámetro.

    3. Actualiza los campos Clave y Valor. Por ejemplo, es posible que desees modificar los siguientes detalles:

      • Nombres de claves de variables de entorno para alinearse con los requisitos de tu aplicación
      • Es el valor del puerto de conexión.
      • Son los roles que se agregaron a una cuenta de servicio.

  5. Haz clic en Guardar.

  6. Para conocer los pasos de implementación, consulta Implementa una aplicación desde la consola.

Edita el código de Terraform

Tu aplicación genera código de Terraform para reflejar los detalles de diseño y configuración. Puedes editar Terraform para especificar los detalles de configuración de los componentes.

El sistema genera los siguientes archivos de Terraform:

  • main.tf: Es el código de infraestructura que incluye un módulo para cada componente de la plantilla.
  • outputs.tf: Expone información sobre los componentes de infraestructura que se implementan.
  • variables.tf: Declara el nombre, el tipo y la descripción de las variables que se usan en el archivo main.tf.
  • input.tfvars: Define valores para las variables que se usan en el archivo main.tf.
  • providers.tf: Define etiquetas que ayudan a Terraform a interactuar con las APIs y los recursos de Google Cloud .

Para obtener información general, consulta Descripción general de Terraform enGoogle Cloud.

Para editar el código de Terraform, haz lo siguiente:

  1. En el lienzo de diseño, haz clic en Código. El sistema muestra los archivos de Terraform generados.

  2. Haz clic en main.tf. El sistema muestra el módulo de Terraform para cada componente.

  3. Edita los detalles de la configuración. Para obtener más información, consulta la documentación de configuración de cada recurso compatible.

    El sistema valida automáticamente tus ediciones y muestra errores si no son válidas.

  4. Para destacar y comparar tus ediciones, haz lo siguiente:

    1. Haz clic en Ver diferencia.

    2. Para revertir un cambio, haz clic en Click to revert change en el margen.

    3. Haz clic en Ver diferencias para cerrar la vista de comparación.

  5. Para guardar los cambios, haz clic en Save code changes.

  6. Para verificar tus cambios, haz lo siguiente.

    1. Haz clic en Diseño.
    2. Haz clic en un componente y revisa los detalles de su configuración.

Crea una revisión de la aplicación

Crea una revisión de la aplicación para modificar detalles o componentes. Si modificas los componentes de la aplicación fuera de App Design Center, esos cambios no se conservarán cuando vuelvas a implementar la aplicación.

Para crear una revisión de la aplicación, haz lo siguiente:

  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 que deseas revisar.

  3. Para modificar los detalles de la aplicación, haz lo siguiente:

    1. Haz clic en Editar y modifica los detalles.
    2. Haz clic en Guardar para guardar los cambios.

  4. Para modificar un componente en esta aplicación, haz lo siguiente:

    1. Haz clic en el componente en el lienzo de diseño y edita los detalles en el área Configuración.

    2. Haz clic en Guardar para guardar los cambios.

  5. Para conocer los pasos de implementación, consulta Implementa una aplicación desde la consola.

Cómo borrar una aplicación

Si ya no necesitas una aplicación, puedes borrarla. Por ejemplo, puedes implementar una aplicación para verificar tu plantilla en el entorno de TEST y, luego, borrarla.

Puedes borrar las siguientes aplicaciones:

  • Es una aplicación que no se implementó. En la página Applications, el Status aparece como Draft.
  • Una aplicación que se implementó en el entorno TEST, DEVELOPMENT o STAGING

Cuando borras una aplicación, ocurre lo siguiente:

  • Los detalles de la aplicación se quitan de Application Design Center.
  • Se borra la aplicación subyacente de App Hub.
  • Si realizaste la implementación, se borran los recursos.

Para borrar una aplicación, haz lo siguiente:

  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. Haz clic en Acciones y selecciona Borrar aplicación.

  4. En el campo Borrar, ingresa el nombre de la aplicación.

  5. Haz clic en Borrar.

¿Qué sigue?

Implementa tu aplicación con una de las siguientes opciones: