Déployer des applications

Le déploiement d'un brouillon d'application dans App Design Center vous permet de provisionner des ressources Google Cloud et d'enregistrer automatiquement votre application dans App Hub. Avant de déployer, vous pouvez prévisualiser les modifications Terraform prévues, évaluer votre conception par rapport règles d'administration et activer les APIGoogle Cloud requises. Après le déploiement, vous pouvez examiner les problèmes de déploiement, analyser les performances des ressources à l'aide des données de télémétrie et appliquer de nouvelles révisions de modèle à votre application.

Avant de commencer

Pour effectuer les tâches décrites dans ce document, demandez à votre administrateur de vous accorder les rôles nécessaires sur le dossier compatible avec les applications ou le projet de gestion, comme indiqué dans le tableau suivant :

Tâche	Rôles requis
Déployer une application et appliquer des révisions de modèle	Administrateur d'application (roles/designcenter.applicationAdmin) ou Opérateur d'application (roles/designcenter.applicationOperator)
Créer automatiquement un compte de service lors du déploiement	Administrateur de projet IAM (roles/resourcemanager.projectIamAdmin)

Pour déployer l'application à l'aide d'un compte de service existant, consultez Attribuer des rôles à votre compte de service.

Pour en savoir plus sur les rôles, consultez Contrôle des accès avec IAM.

Déployer votre application

Sélectionnez une option de compte de service et déployez votre application. Lorsque vous déployez une application, des ressources Google Cloud sont créées et vous commencez à payer des frais associés à ces ressources.

Canevas de conception

1. Dans le menu de navigation, cliquez sur Applications.

   Accéder à la page Applications

2. Dans le tableau, cliquez sur le nom de l'application.

3. Sur la page Détails de l'application, examinez les détails et cliquez sur Modifier pour apporter des modifications.

   Remarque : Si vous prévoyez de déployer, puis de supprimer cette application, déployez-la dans l'environnement TEST, DEVELOPMENT ou STAGING.

4. Cliquez sur Déployer.

5. Sélectionnez l'un des comptes de service suivants pour déployer votre application :

   • Sélectionner un compte de service : dans le champ Compte de service, saisissez le nom d'un compte de service existant. Pour configurer le compte de service, consultez Attribuer des rôles à votre compte de service.

   • Créer un compte de service : vous devez disposer du rôle Administrateur de projet IAM (roles/resourcemanager.projectIamAdmin), qui permet d'attribuer les rôles de déploiement requis au compte de service.

6. Cliquez sur Continuer.

7. Pour prévisualiser les modifications que Terraform prévoit d'apporter à votre infrastructure, procédez comme suit :

   1. Cliquez sur Aperçu.

   2. Examinez les modifications, puis cliquez sur Copier et fermer. L'aperçu est copié dans votre presse-papiers.

   3. Pour enregistrer l'aperçu, collez-le et enregistrez-le dans le document de votre choix.

8. Dans la zone Examiner les API, examinez la liste des API requises pour votre application. Les API sont automatiquement activées lors du déploiement.

9. Cliquez sur Déployer. Les détails de l'application et l'état du déploiement s'affichent une fois le déploiement terminé.

10. Si votre déploiement présente des problèmes, procédez comme suit :

    1. Dans le panneau Détails de l'application, cliquez sur Déploiements.

    2. Examinez les messages d'erreur.

    3. Cliquez sur Afficher les journaux pour afficher des informations détaillées sur la compilation.

    4. Pour afficher des suggestions de correction des erreurs de déploiement, cliquez sur Résoudre les problèmes de déploiement (aperçu).

       Pour en savoir plus, consultez Résoudre les problèmes de déploiement.

    Conseil : Pour afficher la liste des applications présentant des problèmes de déploiement dans Cloud Hub, consultez Afficher les déploiements.

11. Pour gérer votre application déployée, consultez Afficher les détails de l'application.

gcloud CLI

1. Prévisualisez l'application pour afficher le code Terraform avant de la déployer. Cette opération peut prendre plusieurs minutes. Effectuez l'une des opérations suivantes :

   • Pour créer automatiquement un compte de service, utilisez la commande suivante :

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --create-sa \
     --service-account=SERVICE_ACCOUNT
     

   • Pour utiliser votre propre compte de service, exécutez la commande suivante :

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --service-account=SERVICE_ACCOUNT
     

   Remplacez les éléments suivants :

   • APPLICATION : ID d'application.
   • PROJECT : ID de votre projet de gestion.
   • LOCATION : région de l'application.
   • SPACE : ID de votre espace.
   • SERVICE_ACCOUNT : effectuez l'une des opérations suivantes :
     • Pour créer un compte de service, indiquez un nom pour celui-ci.
     • Pour utiliser votre propre compte de service, indiquez le nom complet de la ressource au format projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

   Pour en savoir plus, consultez gcloud design-center spaces applications preview.

2. Déployez l'application de manière asynchrone et copiez le nom complet de l'opération. Effectuez l'une des opérations suivantes :

   Remarque : Pour mettre à jour une application existante, ajoutez l'option --replace aux commandes de déploiement suivantes.

   • Pour créer automatiquement un compte de service, utilisez la commande suivante :

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --create-sa \
      --service-account=SERVICE_ACCOUNT \
      --async
     

   • Pour utiliser votre propre compte de service, exécutez la commande suivante :

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --service-account=SERVICE_ACCOUNT \
      --async
     

   Remplacez les éléments suivants :

   • APPLICATION : ID d'application.
   • PROJECT : ID de votre projet de gestion.
   • LOCATION : région de l'application.
   • SPACE : ID de votre espace.
   • SERVICE_ACCOUNT : effectuez l'une des opérations suivantes :
     • Pour créer un compte de service, indiquez un nom pour celui-ci.
     • Pour utiliser votre propre compte de service, indiquez le nom complet de la ressource au format projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

   Pour en savoir plus, consultez gcloud design-center spaces applications deploy.

3. Le déploiement prend quelques minutes. Suivez l'état du déploiement.

   gcloud design-center operations describe OPERATION\
   --project=PROJECT \
   --location=LOCATION
   

   Remplacez les éléments suivants :

   • OPERATION : nom complet de l'opération copié à partir du résultat de la commande deploy au format projects/PROJECT/locations/LOCATION/operations/operation-<var>OPERATION_ID</var>.
   • PROJECT : ID de votre projet de gestion.
   • LOCATION : région de l'application.

   Pour en savoir plus, consultez gcloud design-center operations describe.

Résoudre les problèmes de déploiement

Aperçu

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions 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.

Si le déploiement de votre application échoue, vous pouvez afficher un résumé des erreurs, obtenir une analyse détaillée, identifier les étapes de résolution et corriger automatiquement certains problèmes.

Pour résoudre les erreurs, procédez comme suit :

1. Dans le panneau Détails de l'application, cliquez sur Déploiements.

2. Pour analyser les erreurs et suggérer des corrections, cliquez sur Résoudre les problèmes de déploiement.

   Le panneau Détails du dépannage affiche des suggestions de documentation, des modifications de configuration et d'autres informations qui peuvent vous aider à résoudre les erreurs de déploiement.

3. Examinez les erreurs et les recommandations de déploiement :

   1. Si l'analyse génère des recommandations de configuration des composants, examinez les modifications suggérées, puis cliquez sur Mettre à jour l'application pour appliquer les modifications.

   2. Si l'analyse génère d'autres recommandations, le système affiche les commandes gcloud CLI que vous pouvez exécuter pour résoudre les erreurs. Pour exécuter les commandes gcloud CLI dans Cloud Shell, cliquez sur Exécuter la commande.

Afficher les détails de l'application

Une fois le déploiement de votre application terminé, vous pouvez examiner les informations associées. Par exemple, vous pouvez voir les éléments suivants :

• Détails tels que l'heure de la dernière mise à jour, la date de révision et la région.
• Les sorties telles que l'URI de service.
• État du déploiement, informations sur les erreurs et liens vers les journaux.

Pour afficher les détails d'une application, procédez comme suit :

Canevas de conception

1. Dans le menu de navigation, cliquez sur Applications.

   Accéder à la page Applications

2. Dans le tableau, cliquez sur le nom de l'application. Le panneau Détails de l'application affiche les éléments suivants :

   • Afficher l'application dans App Hub : examinez votre application dans App Hub. Vous pouvez afficher les ressources déployées et examiner les données de télémétrie pour diagnostiquer les problèmes et analyser les performances. Pour en savoir plus, consultez Surveiller les applications App Hub.

   • Informations sur l'application : affichez des informations telles que la date de la dernière mise à jour, le modèle source, la région et le compte de service.

   • Sorties : identifiez les URI de service, que vous pouvez utiliser pour interagir avec l'interface ou le backend de votre application.

   • Déploiements : examinez l'état du déploiement, les erreurs de déploiement et les liens vers les journaux pour résoudre les erreurs.

gcloud CLI

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

Remplacez les éléments suivants :

• APPLICATION : ID d'application.
• PROJECT : ID de votre projet de gestion.
• LOCATION : région de l'application.
• SPACE : ID de votre espace.

Pour en savoir plus, consultez gcloud design-center spaces applications describe.

Modifier des applications déployées

Si vous souhaitez modifier une application déployée, effectuez l'une des opérations suivantes pour vous assurer que vos modifications sont conservées lorsque vous redéployez l'application :

• Modifiez le modèle, puis appliquez la révision du modèle.
• Modifier l'application

Appliquer les révisions du modèle

Si votre application a déjà été déployée à l'aide d'App Design Center et qu'un administrateur a partagé une révision de modèle avec vous, vous pouvez appliquer les modifications du modèle à votre application. Lorsque vous mettez à jour votre application, une révision d'application est créée. Vous pouvez configurer les composants qui ont été modifiés ou ajoutés au modèle révisé.

Vous pouvez afficher les révisions de modèles disponibles pour vos applications à l'aide de Cloud Hub. Pour en savoir plus, consultez Afficher les déploiements.

Pour appliquer les révisions de modèle à votre application, procédez comme suit :

Attention : Si vous avez modifié les composants d'une application en dehors d'App Design Center, ces modifications ne sont pas conservées lors du redéploiement. Pour conserver les modifications, consultez Modifier les applications déployées.

Canevas de conception

1. Dans le menu de navigation, cliquez sur Modèles.

   Accéder aux modèles

2. Cliquez sur l'ID du modèle contenant la révision que vous souhaitez appliquer.

3. Dans la liste Configurer une application, sélectionnez l'application que vous souhaitez mettre à jour.

4. Modifiez les détails de l'application, puis cliquez sur Enregistrer.

5. Cliquez sur chaque composant dans le canevas de conception et modifiez les configurations des composants.

6. Cliquez sur Déployer. Pour connaître la procédure de déploiement, consultez Déployer votre application.

gcloud CLI

1. Identifiez l'URI de la dernière révision du modèle d'application.

    gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --format='yaml(name,latestRevision)'
   

   Remplacez les éléments suivants :

   • APPLICATION_TEMPLATE : ID du modèle d'application sur lequel repose votre application.
   • PROJECT : ID de votre projet de gestion.
   • LOCATION : région du modèle d'application.
   • SPACE : ID de votre espace.

   Pour en savoir plus, consultez gcloud design-center spaces application-templates describe.

2. Copiez le résultat de latestRevision.

3. Mettez à jour l'application pour utiliser la révision du modèle d'application.

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

   Remplacez les éléments suivants :

   • APPLICATION : ID d'application.
   • PROJECT : ID de votre projet de gestion.
   • LOCATION : région de l'application.
   • SPACE : ID de votre espace.
   • SOURCE_APPLICATION_TEMPLATE_REVISION : URI de votre modèle d'application. Par exemple, projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION.

   Pour en savoir plus, consultez gcloud design-center spaces applications update.

4. Pour configurer des composants nouveaux ou mis à jour dans l'application, consultez Configurer des composants et des connexions.

5. Lorsque vous déployez l'application, utilisez l'option --replace. Pour connaître la procédure de déploiement, consultez Déployer votre application.

Étapes suivantes

• Suivez vos charges de travail en surveillant l'état et les performances de l'application.
• Faites vos premiers pas avec des architectures préconfigurées en créant des modèles Google.