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évisualisez les modifications que Terraform prévoit d'apporter à votre infrastructure.
  • Activez les API de ressources Google Cloud requises pour votre application.
  • Examiner les problèmes de déploiement
  • Utilisez les données de télémétrie pour analyser les performances des ressources.
  • Identifiez et appliquez les 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 pour lequel les applications sont activées :

  • 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 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, des ressources Google Cloud sont créées et vous commencez à payer 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, vérifiez les informations, puis 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électionnez 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. Vérifiez 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 section Examiner les API, consultez 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 à mesure que le déploiement se termine.

  10. Si vous rencontrez des problèmes avec votre déploiement, procédez comme suit :

    1. Dans le panneau Informations sur 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.

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

CLI gcloud

  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 de l'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 son nom.
      • 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 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 :

    • 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 de l'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 son nom.
      • 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 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 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 de gestion.
    • LOCATION : région de l'application.

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

Afficher les détails de la demande

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 informations telles que l'heure de la dernière mise à jour, la date de révision et la région.
  • Sorties telles que l'URI du 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 informations suivantes :

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

    • 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 et les erreurs de déploiement, et accédez aux journaux pour résoudre les problèmes.

CLI gcloud 

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

Remplacez les éléments suivants :

  • APPLICATION : ID de l'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 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 les révisions du modèle

Si votre application a déjà été déployée à l'aide du centre de conception d'applications 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è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 :

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 la demande, 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.

CLI gcloud

  1. Identifiez l'URI de la 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 sur lequel votre application est basée.
    • 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 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 de l'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 modifiés 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.