Crea y administra implementaciones

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.

Nota: Para enviar comentarios o hacer preguntas relacionadas con esta función de versión preliminar, comunícate con [e-mail].

Las implementaciones te permiten programar la ejecución de código, por ejemplo, canalizaciones, que se almacena en repositorios de Git remotos. Puedes elegir el directorio en el que se encuentra tu código y realizar las siguientes acciones:

• Crea y administra implementaciones conectadas a repositorios remotos.
• Configurar activadores para extraer código de repositorios remotos y ejecutarlo de forma periódica
• Ejecuta canalizaciones según una programación o con otros activadores.
• Visualiza los registros de tus ejecuciones directamente en la consola de Google Cloud . Para las alertas, las implementaciones de Dataform se integran en Cloud Logging y Cloud Monitoring.

Limitaciones

• Las implementaciones no tienen alertas integradas. Debes usar Logging y Monitoring para configurar alertas.
• La autenticación con Developer Connect solo admite conexiones y no conectores de cuentas.

Antes de comenzar

Antes de crear una implementación, completa las siguientes tareas:

• Habilita el uso de la página Pipelines & Connections en la consola de Google Cloud .

• Habilita la API de BigQuery, la API de Dataform y la API de Developer Connect:

  Habilitar las API

• Conecta un repositorio remoto con Developer Connect.

Roles obligatorios

Para obtener los permisos que necesitas para completar las tareas de este documento, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Administrador de Dataform (roles/dataform.admin) en el proyecto
• Usuario de trabajo de BigQuery (roles/bigquery.jobUser) en el proyecto
• Visualizador de Developer Connect (roles/developerconnect.viewer) en el proyecto
• Usar una cuenta de servicio personalizada para ejecutar una implementación: Usuario de cuenta de servicio (roles/iam.serviceAccountUser) en la cuenta de servicio personalizada

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.

Para usar una cuenta de servicio personalizada para ejecutar una implementación, también debes otorgar el rol de editor de datos de BigQuery (roles/bigquery.dataEditor) a la cuenta de servicio personalizada.

Crear una implementación

Para crear una implementación de Dataform, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Pipelines & Connections.

   Ir a Canalizaciones y conexiones

2. Haz clic en Crear > Crear implementación.

3. Selecciona un tipo de autenticación del repositorio y, luego, una de las siguientes opciones:

   Developer Connect

   1. Selecciona un repositorio y una rama.
   2. Ingresa la ruta de acceso al directorio en el que se encuentra el código.
   3. Ingresa un nombre para la implementación.
   4. Selecciona una región para la implementación.

   5. En la sección frecuencia de programación, haz lo siguiente:

      1. En el menú Repeticiones, selecciona la frecuencia de las ejecuciones de canalización programadas.
      2. En el campo En el momento, ingresa la hora de las ejecuciones de canalización programadas.
      3. En el menú Zona horaria, selecciona la zona horaria para la programación.

      Como alternativa, selecciona Bajo demanda para ejecutar la implementación cuando lo desees.

   6. Opcional: Ingresa el Google Cloud ID del proyecto.

   7. Opcional: Ingresa un sufijo de esquema.

   8. Opcional: Ingresa un prefijo de tabla.

   9. Opcional: Ingresa el esquema predeterminado.

   10. Opcional: Ingresa variables de compilación.

   11. Haz clic en Implementar.

   HTTPS

   1. Ingresa la URL de tu repositorio de Git remoto.
   2. Selecciona una rama.
   3. Ingresa la ruta de acceso al directorio en el que se encuentra el código.
   4. Ingresa el secreto que contiene el token de acceso personal para los remotos HTTPS. Para obtener más información, consulta Conecta un repositorio remoto a través de HTTPS.
   5. Ingresa un nombre para la implementación.
   6. Selecciona una región para la implementación.

   7. En la sección frecuencia de programación, haz lo siguiente:

      1. En el menú Repeticiones, selecciona la frecuencia de las ejecuciones de canalización programadas.
      2. En el campo En el momento, ingresa la hora de las ejecuciones de canalización programadas.
      3. En el menú Zona horaria, selecciona la zona horaria para la programación.

      Como alternativa, selecciona Bajo demanda para ejecutar la implementación cuando lo desees.

   8. Opcional: Ingresa el Google Cloud ID del proyecto.

   9. Opcional: Ingresa un sufijo de esquema.

   10. Opcional: Ingresa un prefijo de tabla.

   11. Opcional: Ingresa el esquema predeterminado.

   12. Opcional: Ingresa variables de compilación.

   13. Haz clic en Implementar.

   SSH

   1. Ingresa la URL de tu repositorio de Git remoto.
   2. Selecciona una rama.
   3. Ingresa la ruta de acceso al directorio en el que se encuentra el código.
   4. Ingresa el secreto que contiene una clave privada del usuario y el valor de la clave de host pública de SSH. Para obtener más información, consulta Conecta un repositorio remoto a través de SSH.
   5. Ingresa un nombre para la implementación.
   6. Selecciona una región para la implementación.

   7. En la sección frecuencia de programación, haz lo siguiente:

      1. En el menú Repeticiones, selecciona la frecuencia de las ejecuciones de canalización programadas.
      2. En el campo En el momento, ingresa la hora de las ejecuciones de canalización programadas.
      3. En el menú Zona horaria, selecciona la zona horaria para la programación.

      Como alternativa, selecciona Bajo demanda para ejecutar la implementación cuando lo desees.

   8. Opcional: Ingresa el Google Cloud ID del proyecto.

   9. Opcional: Ingresa un sufijo de esquema.

   10. Opcional: Ingresa un prefijo de tabla.

   11. Opcional: Ingresa el esquema predeterminado.

   12. Opcional: Ingresa variables de compilación.

   13. Haz clic en Implementar.

Mostrar lista de implementaciones

Para enumerar las implementaciones creadas, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Pipelines & Connections.

   Ir a Canalizaciones y conexiones

2. Consulta la lista de implementaciones.

Crea una programación de implementación

Para crear una programación para una implementación, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Pipelines & Connections.

   Ir a Canalizaciones y conexiones

2. Haz clic en la pestaña Implementaciones y, luego, selecciona una implementación.

3. En la página Detalles de la implementación, en la sección Activadores (configuraciones de flujo de trabajo), haz clic en Crear.

4. En el panel Crear configuración de flujo de trabajo, sigue los pasos para crear una configuración de flujo de trabajo.

Ejecuta un programa de implementación

Para ejecutar una programación para una implementación, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Pipelines & Connections.

   Ir a Canalizaciones y conexiones

2. Haz clic en la pestaña Deployments y, luego, selecciona una implementación.

3. En la sección Triggers (workflow configurations), junto al programa de implementación que deseas ejecutar, haz clic en Ver acciones > Ejecutar ahora.

Cómo borrar una programación de implementación

Para borrar una programación de una implementación, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Pipelines & Connections.

   Ir a Canalizaciones y conexiones

2. Haz clic en la pestaña Implementaciones y, luego, selecciona una implementación.

3. En la página Detalles de la implementación, en la sección Activadores (configuraciones de flujo de trabajo), junto al programa de implementación que deseas borrar, haz clic en Ver acciones > Borrar.

Configura alertas

Para recibir notificaciones cuando falla una ejecución de flujo de trabajo, configura alertas para las invocaciones de flujo de trabajo fallidas.

¿Qué sigue?

• Obtén más información para crear un repositorio.
• Obtén más información para programar ejecuciones.
• Obtén más información para configurar alertas.