Déployer des applications

Une fois que vous avez créé un brouillon d'application à partir d'un modèle, vous pouvez déployer l'application. Lorsque vous déployez une application à l'aide d'App Design Center, elle est automatiquement enregistrée dans App Hub. Le processus de déploiement vous permet d'effectuer les opérations suivantes :

  • Prévisualiser les modifications que Terraform prévoit d'apporter à votre infrastructure.
  • Activer Google Cloud les API de ressources requises pour votre application.
  • Examiner les problèmes de déploiement.
  • Utiliser des données de télémétrie pour analyser les performances des ressources.
  • Identifier et appliquer des révisions de modèle à votre application.

Ce document vous aide à déployer, à gérer et à appliquer une révision de modèle à votre application.

Avant de commencer

Vous devez disposer de l'un des rôles suivants dans le dossier ou le projet de gestion compatible avec les applications :

  • Administrateur d'application (roles/designcenter.applicationAdmin)
  • Opérateur d'application (roles/designcenter.applicationOperator)

Pour déployer l'application avec un compte de service, vous devez disposer de l'un des éléments suivants :

  • Votre propre compte de service que vous avez configuré pour déployer des applications et des ressources sous-jacentes. Pour en savoir plus, consultez la section Attribuer des rôles à votre compte de service.
  • Le rôle Administrateur IAM du projet (roles/resourcemanager.projectIamAdmin) dans le dossier compatible avec les applications. Ce rôle vous permet de créer un compte de service lors du déploiement.

Déployer votre application

Sélectionnez une option de compte de service et déployez votre application. Lorsque vous déployez une application, Google Cloud des ressources sont créées et vous commencez à être facturé pour les 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.

  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 la section Attribuer des rôles à votre compte de service.

    • Créer un compte de service : vous devez disposer du rôle Administrateur IAM du projet (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 dans le document de votre choix, puis enregistrez-le.

  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 vous rencontrez des problèmes lors du déploiement, 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 permettant de corriger les erreurs de déploiement, cliquez sur Résoudre les problèmes de déploiement (aperçu).

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

  11. Pour gérer votre application déployée, consultez la section 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, exécutez 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 application.
    • PROJECT : ID de votre projet.
    • 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 le compte de service.
      • Pour utiliser votre propre compte de service, indiquez le nom de ressource complet au format projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

    Pour en savoir plus, consultez la section Prévisualiser les applications dans les espaces du centre de conception gcloud.

  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 :

    • Pour créer automatiquement un compte de service, exécutez 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 application.
    • PROJECT : ID de votre projet.
    • 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 le compte de service.
      • Pour utiliser votre propre compte de service, indiquez le nom de ressource complet au format projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

    Pour en savoir plus, consultez la section Déployer des applications dans les espaces du centre de conception gcloud.

  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 de la résultat de la commande deploy, au format projects/PROJECT/locations/LOCATION/operations/operation-<var>OPERATION_ID</var>.
    • PROJECT : ID de votre projet.
    • LOCATION : région de l'application.

    Pour en savoir plus, consultez la section Décrire les opérations du centre de conception gcloud.

Résoudre les problèmes de déploiement

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 à suivre pour résoudre le problème 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 de la résolution des problèmes 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 de 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 afficher les éléments suivants :

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

Pour afficher les détails de l'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 la section Surveiller les applications App Hub applications.

    • Détails de 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 le frontend 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 application.
  • PROJECT : ID de votre projet.
  • LOCATION : région de l'application.
  • SPACE : ID de votre espace.

Pour en savoir plus, consultez la section Décrire les applications dans les espaces du centre de conception gcloud.

Modifier les 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 :

Appliquer des révisions de 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 de l'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èle disponibles pour vos applications à l'aide de Cloud Hub. Pour en savoir plus, consultez la section Afficher les déploiements.

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

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 du canevas de conception, puis modifiez les configurations des composants.

  6. Cliquez sur Déployer. Pour connaître les étapes de déploiement, consultez la section Déployer votre application.

Gcloud CLI

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

     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 qui sert de base à votre application.
    • PROJECT : ID de votre projet.
    • LOCATION : région du modèle d'application.
    • SPACE : ID de votre espace.

    Pour en savoir plus, consultez la section Décrire les modèles d'application dans les espaces du centre de conception gcloud.

  2. Copiez la sortie 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 application.
    • PROJECT : ID de votre projet.
    • 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 la section Mettre à jour les applications dans les espaces du centre de conception gcloud.

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

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