Administrar aplicaciones

Crear un borrador de aplicación a partir de una plantilla en Application Design Center te permite personalizar e implementar instancias de aplicación independientes para entornos como pruebas y producción. Cuando creas un borrador de aplicación, especificas atributos para categorizar y filtrar la aplicación, configurar componentes y conexiones y, de manera opcional, editar el código de Terraform generado. También puedes crear revisiones nuevas a medida que cambien tus requisitos y borrar la aplicación cuando ya no necesites los recursos implementados.

Antes de comenzar

Para realizar las tareas de este documento, pídele a tu administrador que te otorgue los roles necesarios en la carpeta habilitada para apps o el proyecto de administración, como se indica en la siguiente tabla:

Tarea	Roles obligatorios
Crear, configurar, editar y crear versiones de borradores de aplicaciones	Administrador de Application Design Center (roles/designcenter.admin), o Administrador de aplicaciones (roles/designcenter.applicationAdmin), o Editor de aplicaciones (roles/designcenter.applicationEditor)
Borra una aplicación	Administrador de Application Design Center (roles/designcenter.admin) o Administrador de aplicaciones (roles/designcenter.applicationAdmin)

Para obtener más información sobre los roles, consulta Control de acceso con IAM.

Crea un borrador de la aplicación

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

Lienzo de diseño

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

   • Para ver las plantillas creadas en tu espacio, haz clic en Plantillas.

     Ir a Plantillas

   • Para ver las plantillas compartidas desde otro espacio, haz clic en Plantillas compartidas.

     Ir a Plantillas compartidas

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

3. En el lienzo de diseño, haz clic en Configurar una app y, luego, en Crear una 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 es un campo obligatorio.

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

   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. En un límite a nivel de carpeta, el proyecto debe tener las siguientes calificaciones:

   • El proyecto debe estar dentro de la carpeta habilitada para apps seleccionada.
   • El proyecto no debe ser un proyecto de administración.

   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 quieras verificar que tu implementación funcione como se espera en TEST.

   Nota: Si planeas implementar y, luego, borrar esta aplicación, impleméntala en TEST, DEVELOPMENT o STAGING.

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

9. Para especificar los 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 de desarrolladores, ingresa un propietario que sea responsable del desarrollo y la programación.

   • En el área Propietarios de operadores, 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 es un campo obligatorio. Para obtener más información, consulta Compara aplicaciones globales y regionales.

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

gcloud CLI

1. Identifica el URI de revisión de la plantilla de aplicación que deseas usar para crear la aplicación.

    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 deseas usar 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 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. Crea un borrador de aplicación basado en tu plantilla.

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

   Reemplaza lo siguiente:

   • APPLICATIONEs el ID de la aplicación para el borrador de la aplicación que quieres crear.
   • 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
   • SCOPE_TYPE: Es el alcance de tu aplicación. Puede ser regional o global. Si el alcance de la aplicación es "global, the region is applied to components that don't already have a configured region. If the application scope isregional", la región se aplica a todos los componentes.

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

Configurar 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:

Lienzo de diseño

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 con las siguientes características:

   • El proyecto debe estar dentro de la carpeta habilitada para apps seleccionada.

   • El proyecto no debe ser un proyecto de administración.

3. Establece parámetros de configuración adicionales para el recurso. Por ejemplo, para Cloud SQL, puedes configurar lo siguiente:

   • Región
   • Configuración de las copias de seguridad
   • Marcas de bases 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 los valores de configuración predeterminados para crear la conexión. Para agregar o modificar los detalles de la 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 Conexión 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 quieras modificar los siguientes detalles:

      • Los nombres de las claves de variable de entorno para que se alineen con los requisitos de tu aplicación.
      • Es el valor del puerto de conexión.
      • Los roles que se agregan a una cuenta de servicio.

5. Haz clic en Guardar.

gcloud CLI

1. Describir la aplicación para ver los parámetros de los componentes y, luego, identificar los parámetros obligatorios para tu aplicación

    gcloud design-center spaces applications describe APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --format='yaml(name,componentParameters)'
   

   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.

2. Para cada componente que desees modificar, crea un archivo JSON que contenga valores de parámetros en tu directorio principal.

   Por ejemplo, puedes crear el siguiente archivo para un componente de Cloud Run:

     {
       "component": "projects/PROJECT/locations/us-central1/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/components/COMPONENT",
       "parameters": [
          {
             "key": "service_name",
             "value": "frontend-service"
          },
          {
             "key": "project_id",
             "value": "DEPLOYMENT_PROJECT"
          }
       ]
     }
   

3. Actualiza la aplicación para configurar los parámetros requeridos.

    gcloud design-center spaces applications update APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --component-parameters=COMPONENT_FILE_PATH_1
   

   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.
   • COMPONENT_FILE_PATH_1: Es un archivo JSON que incluye parámetros de componentes. Para cada archivo JSON adicional, agrega otro argumento y valor --component-parameter.

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

Para conocer los pasos de implementación, consulta Implementa aplicaciones.

Verifica el cumplimiento de la seguridad

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio 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.

Puedes realizar una evaluación de seguridad de tu aplicación para validar tu configuración con los frameworks de Security Command Center. En esta evaluación integral, se analiza lo siguiente:

• Valores de configuración del componente: Son los parámetros de configuración que se heredaron automáticamente de la plantilla o los parámetros que modificaste para esta aplicación.
• Parámetros de la aplicación: Son los detalles específicos de la instancia que se proporcionan para tu aplicación, como la región o el entorno de implementación.
• Componentes permitidos: Son los servicios y las cargas de trabajo de la aplicación actual que tu organización puede usar.

Las aplicaciones heredan los frameworks de Security Command Center de su plantilla. Primero, tu administrador debe adjuntar un framework de seguridad a tu plantilla de aplicación. Luego, haz lo siguiente para evaluar el cumplimiento de seguridad de tu aplicación:

gcloud CLI

  gcloud alpha design-center spaces applications preview APPLICATION \
  --project=PROJECT \
  --location=LOCATION \
  --space=SPACE \
  --generate-assessment-report=true

Reemplaza lo siguiente:

• APPLICATION: Es el ID de aplicación que deseas evaluar.
• 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.

En el resultado, se muestra un informe de evaluación de tu aplicación según los frameworks adjuntos de la plantilla.

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 los valores de 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 en Google 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. Editar 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 estas 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, en el margen, haz clic en Haz clic para revertir el cambio.

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

5. Para guardar las modificaciones, haz clic en Guardar cambios en el código.

6. Para verificar los 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 los detalles o los componentes. Si modificas los componentes de la aplicación fuera de App Design Center, esos cambios no se conservarán cuando vuelvas a realizar la implementación.

Para crear una revisión 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 que quieres revisar.

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

4. Haz clic en Editar y modifica los detalles.

5. Haz clic en Guardar para guardar los cambios.

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

gcloud CLI

Consulta Configura componentes y conexiones.

Para conocer los pasos de implementación, consulta Implementa aplicaciones.

Borra 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, borrar la aplicación.

Puedes borrar las siguientes aplicaciones:

• Una aplicación que no se implementó En la página Aplicaciones, el Estado aparece como Borrador.
• Una aplicación que se implementó en el entorno de 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 implementaste, se borrarán los recursos.

Para borrar una aplicación, sigue estos pasos:

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

gcloud CLI

Borrar una aplicación

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

Reemplaza lo siguiente:

• APPLICATION: Es el ID de aplicación que deseas borrar.
• 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 delete.

¿Qué sigue?

• Aprovisiona tu infraestructura con la consola o la línea de comandos implementando aplicaciones.
• Exporta las configuraciones de Terraform a tu máquina o repositorio local descargando e implementando Terraform.