Créer et gérer des déploiements

Aperçu

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres pré-DG" de la section "Conditions d'utilisation générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Remarque : Pour envoyer des commentaires ou poser des questions concernant cette fonctionnalité en preview, contactez [e-mail].

Les déploiements vous permettent de planifier l'exécution de code (par exemple, des pipelines) stocké dans des dépôts Git distants. Vous pouvez choisir le répertoire dans lequel votre code est situé et effectuer les actions suivantes :

• Créer et gérer des déploiements connectés à des dépôts distants.
• Configurer des déclencheurs pour extraire du code à partir de dépôts distants et exécuter du code régulièrement.
• Exécuter des pipelines selon une programmation ou avec d'autres déclencheurs.
• Afficher les journaux de vos exécutions directement dans la Google Cloud console. Pour les alertes, les déploiements Dataform s'intègrent à Cloud Logging et Cloud Monitoring.

Limites

• Les déploiements ne disposent pas d'alertes intégrées. Vous devez utiliser Logging et Monitoring pour configurer des alertes.
• L'authentification avec Developer Connect n'est compatible qu'avec les connexions, et non avec les connecteurs de compte.

Avant de commencer

Avant de créer un déploiement, effectuez les tâches suivantes :

• Acceptez d'utiliser la page Pipelines et connexions dans la Google Cloud console.

• Activez l'API BigQuery, l'API Dataform et l'API Developer Connect :

  Activer les API

• Connectez un dépôt distant à l'aide de Developer Connect.

Rôles requis

Pour obtenir les autorisations nécessaires pour effectuer les tâches décrites dans ce document, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Administrateur Dataform (roles/dataform.admin) sur le projet
• Utilisateur de job BigQuery (roles/bigquery.jobUser) sur le projet
• Lecteur Developer Connect (roles/developerconnect.viewer) sur le projet
• Utilisez un compte de service personnalisé pour exécuter un déploiement : Utilisateur du compte de service (roles/iam.serviceAccountUser) sur le compte de service personnalisé

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Pour utiliser un compte de service personnalisé afin d'exécuter un déploiement, vous devez également attribuer le rôle Éditeur de données BigQuery (roles/bigquery.dataEditor) au compte de service personnalisé.

Créer un déploiement

Pour créer un déploiement Dataform, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Pipelines et connexions.

   Accéder à Pipelines et connexions

2. Cliquez sur Créer > Créer un déploiement.

3. Sélectionnez un type d'authentification de dépôt, puis l'une des options suivantes :

   Developer Connect

   1. Sélectionnez un dépôt et une branche.
   2. Saisissez le chemin d'accès au répertoire dans lequel se trouve le code.
   3. Saisissez un nom pour le déploiement.
   4. Sélectionnez une région pour le déploiement.

   5. Dans la section Fréquence de programmation, procédez comme suit :

      1. Dans le menu Répétitions, sélectionnez la fréquence d'exécution des pipelines programmés.
      2. Dans le champ À, saisissez l'heure d'exécution des pipelines programmés.
      3. Dans le menu Fuseau horaire, sélectionnez le fuseau horaire de la programmation.

      Vous pouvez également sélectionner À la demande pour exécuter votre déploiement à la demande.

   6. Facultatif : Saisissez l'ID du Google Cloud projet.

   7. Facultatif : Saisissez un suffixe de schéma.

   8. Facultatif : Saisissez un préfixe de table.

   9. Facultatif : Saisissez le schéma par défaut.

   10. Facultatif : Saisissez des variables de compilation.

   11. Cliquez sur Déployer.

   HTTPS

   1. Saisissez l'URL de votre dépôt Git distant.
   2. Sélectionnez une branche.
   3. Saisissez le chemin d'accès au répertoire dans lequel se trouve le code.
   4. Saisissez le secret contenant le jeton d'accès personnel pour les dépôts HTTPS distants. Pour en savoir plus, consultez Connecter un dépôt distant via HTTPS.
   5. Saisissez un nom pour le déploiement.
   6. Sélectionnez une région pour le déploiement.

   7. Dans la section Fréquence de programmation, procédez comme suit :

      1. Dans le menu Répétitions, sélectionnez la fréquence d'exécution des pipelines programmés.
      2. Dans le champ À, saisissez l'heure d'exécution des pipelines programmés.
      3. Dans le menu Fuseau horaire, sélectionnez le fuseau horaire de la programmation.

      Vous pouvez également sélectionner À la demande pour exécuter votre déploiement à la demande.

   8. Facultatif : Saisissez l'ID du Google Cloud projet.

   9. Facultatif : Saisissez un suffixe de schéma.

   10. Facultatif : Saisissez un préfixe de table.

   11. Facultatif : Saisissez le schéma par défaut.

   12. Facultatif : Saisissez des variables de compilation.

   13. Cliquez sur Déployer.

   SSH

   1. Saisissez l'URL de votre dépôt Git distant.
   2. Sélectionnez une branche.
   3. Saisissez le chemin d'accès au répertoire dans lequel se trouve le code.
   4. Saisissez le secret contenant une clé privée utilisateur et la valeur de la clé publique de l'hôte SSH. Pour en savoir plus, consultez Connecter un dépôt distant via SSH.
   5. Saisissez un nom pour le déploiement.
   6. Sélectionnez une région pour le déploiement.

   7. Dans la section Fréquence de programmation, procédez comme suit :

      1. Dans le menu Répétitions, sélectionnez la fréquence d'exécution des pipelines programmés.
      2. Dans le champ À, saisissez l'heure d'exécution des pipelines programmés.
      3. Dans le menu Fuseau horaire, sélectionnez le fuseau horaire de la programmation.

      Vous pouvez également sélectionner À la demande pour exécuter votre déploiement à la demande.

   8. Facultatif : Saisissez l'ID du Google Cloud projet.

   9. Facultatif : Saisissez un suffixe de schéma.

   10. Facultatif : Saisissez un préfixe de table.

   11. Facultatif : Saisissez le schéma par défaut.

   12. Facultatif : Saisissez des variables de compilation.

   13. Cliquez sur Déployer.

Répertorier les déploiements

Pour répertorier les déploiements créés, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Pipelines et connexions.

   Accéder à Pipelines et connexions

2. Affichez la liste des déploiements.

Créer une programmation de déploiement

Pour créer une programmation pour un déploiement, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Pipelines et connexions.

   Accéder à Pipelines et connexions

2. Cliquez sur l'onglet Déploiements, puis sélectionnez un déploiement.

3. Sur la page Informations sur le déploiement, dans la section Déclencheurs (configurations de workflow), cliquez sur Créer.

4. Dans le volet Créer une configuration de workflow, suivez les étapes pour créer une configuration de workflow.

Exécuter une programmation de déploiement

Pour exécuter une programmation pour un déploiement, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Pipelines et connexions.

   Accéder à Pipelines et connexions

2. Cliquez sur l'onglet Déploiements , puis sélectionnez un déploiement.

3. Dans la section Déclencheurs (configurations de workflow), à côté de la programmation de déploiement que vous souhaitez exécuter, cliquez sur Afficher les actions > Exécuter maintenant.

Supprimer une programmation de déploiement

Pour supprimer une programmation pour un déploiement, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Pipelines et connexions.

   Accéder à Pipelines et connexions

2. Cliquez sur l'onglet Déploiements, puis sélectionnez un déploiement.

3. Sur la page Informations sur le dépliers, dans la sectionDéclencheurs (configurations de workflow), à côté de la programmation de déploiement que vous souhaitez supprimer, cliquez sur Afficher les actions > Supprimer.

Configurer des alertes

Pour recevoir des notifications en cas d'échec d'une exécution de workflow, configurez des alertes pour les appels de workflow ayant échoué.

Étape suivante

• Découvrez comment créer un dépôt.
• Découvrez comment planifier des exécutions.
• Découvrez comment configurer des alertes.