Gérer les applications App Hub

Lorsque vous configurez App Hub, vous créez une limite administrative pour vos applications. Cette limite correspond au projet de gestion ou à l'ensemble des projets hôtes et de service que vous avez configurés pour la gestion des applications, selon votre modèle de configuration. Les services et les charges de travail sont enregistrés en tant qu'applications à l'intérieur de cette limite administrative.

Pour éviter la dérive de configuration et maintenir une source de vérité claire, nous vous recommandons de gérer les ressources de votre application dans l'environnement où elles ont été définies à l'origine :

  • Pour les applications déployées à partir d'un modèle App Design Center : utilisez App Design Center pour gérer et mettre à jour l'application. Vous pouvez modifier le modèle pour apporter des modifications à la conception de l'application ou créer une révision de l'application pour mettre à jour des paramètres tels que les détails de l'application et des composants.

    Accéder à App Design Center

  • Pour les applications créées en enregistrant des ressources dans App Hub : gérez l'application, ses services et ses charges de travail directement dans App Hub.

    Accéder au hub d'applications

Cette page explique comment gérer les applications enregistrées directement dans App Hub. Vous pouvez effectuer ces actions à l'aide de la console Google Cloud ou de la Google Cloud CLI. Pour les applications déployées à partir d'un modèle, consultez la documentation Application Design Center.

Avant de commencer

Avant de pouvoir lister, afficher, mettre à jour et supprimer des applications dans App Hub, procédez comme suit :

  1. Configurez App Hub à l'aide de l'un des modèles de configuration compatibles.
  2. Créez une application et enregistrez les ressources compatibles avec l'application que vous souhaitez gérer.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les applications dans App Hub, demandez à votre administrateur de vous accorder les rôles IAM suivants sur la limite administrative de l'application à partir de votre modèle de configuration (le projet de gestion ou les projets hôte et de service) :

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 avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles App Hub, consultez Rôles et autorisations IAM pour App Hub.

Lister les applications

Pour lister et filtrer toutes les applications dans votre périmètre administratif App Hub :

Console

  1. Sur la page Bienvenue de la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion ou votre projet hôte :

    Accéder à la page d'accueil

  2. Accédez à la page Applications d'App Hub :

    Accéder à la page Applications

    La page affiche la liste de vos applications.

  3. Pour filtrer la liste, utilisez le champ Filtre. Vous pouvez filtrer par attributs tels que Criticalité ou Environnement.

gcloud

  1. Trouvez l'ID du projet de votre projet de gestion ou de votre projet hôte.

  2. Affichez la liste de vos applications en utilisant l'une des options suivantes :

    • Répertoriez toutes les applications :

      gcloud apphub applications list \
    --project=PROJECT_ID \
    --location=LOCATION

      Remplacez les éléments suivants :

      • PROJECT_ID : ID de votre projet hôte ou de gestion.
      • LOCATION : emplacement de vos applications. Utilisez global pour les applications mondiales ou une région spécifique, comme us-east1, pour les applications régionales.

    • Filtrez la liste des applications en fonction des attributs à l'aide de l'indicateur --filter :

      gcloud apphub applications list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --filter=FILTER_EXPRESSION \

      Remplacez les éléments suivants :

      • PROJECT_ID : ID de votre projet hôte ou de gestion.
      • LOCATION : emplacement de vos applications. Utilisez global pour les applications mondiales ou une région spécifique, comme us-east1, pour les applications régionales.
      • FILTER_EXPRESSION : expression de filtre permettant de spécifier des attributs. Par exemple, pour lister toutes les applications dont le type d'environnement est PRODUCTION, utilisez attributes.environment.type=PRODUCTION.

Afficher les détails de la demande

Pour afficher les informations détaillées d'une application spécifique, y compris ses attributs et ses métadonnées, procédez comme suit :

Console

  1. Sur la page Bienvenue de la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion ou votre projet hôte :

    Accéder à la page d'accueil

  2. Accédez à la page Applications d'App Hub :

    Accéder à la page Applications

    La page affiche la liste de vos applications.

  3. Cliquez sur le nom de l'application que vous souhaitez afficher.

    L'onglet Détails de l'application s'affiche.

gcloud

  1. Trouvez l'ID du projet de votre projet de gestion ou de votre projet hôte.

  2. Décrivez une application :

    gcloud apphub applications describe APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION

    Remplacez les éléments suivants :

    • APPLICATION_NAME : nom de votre application. Vous spécifiez cette valeur lorsque vous créez une application.
    • PROJECT_ID : ID de votre projet hôte ou de gestion.
    • LOCATION : emplacement de votre application. Utilisez global pour les applications mondiales ou une région spécifique, comme us-east1, pour les applications régionales.

Mettre à jour les attributs de l'application

Pour modifier les attributs définis par l'utilisateur d'une application après sa création, procédez comme suit :

Console

  1. Sur la page Bienvenue de la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion ou votre projet hôte :

    Accéder à la page d'accueil

  2. Accédez à la page Applications d'App Hub :

    Accéder à la page Applications

    La page affiche la liste de vos applications.

  3. Pour l'application que vous souhaitez mettre à jour, cliquez sur Modifier.

  4. Dans le volet Modifier l'application, modifiez les champs selon vos besoins.

  5. Cliquez sur Enregistrer.

gcloud

  1. Trouvez l'ID du projet de votre projet de gestion ou de votre projet hôte.

  2. Mettez à jour les attributs de l'application. Vous pouvez mettre à jour n'importe quel attribut mutable, tel que display-name, criticality-type, environment-type et les propriétaires :

    gcloud apphub applications update APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --display-name=DISPLAY_NAME \
    --criticality-type=CRITICALITY_LEVEL \
    --environment-type=ENVIRONMENT \
    --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
    --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
    --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL

    Remplacez les éléments suivants :

    • Obligatoire : APPLICATION_NAME, nom de votre application. Vous spécifiez cette valeur lorsque vous créez une application.
    • Obligatoire : PROJECT_ID : ID de votre projet hôte ou de votre projet de gestion.
    • Obligatoire : LOCATION : emplacement de votre application. Utilisez global pour les applications mondiales ou une région spécifique, comme us-east1, pour les applications régionales.
    • Facultatif : DISPLAY_NAME : nom à afficher de votre application.

    • CRITICALITY_LEVEL (facultatif) : niveau d'importance de l'application. Appliquez l'une des valeurs suivantes :

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW

    • ENVIRONMENT (facultatif) : étape du cycle de vie du logiciel. Appliquez l'une des valeurs suivantes :

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST

    • Facultatif : DEV_NAME et DEV_EMAIL : nom à afficher et adresse e-mail du propriétaire du développeur, respectivement.

    • Facultatif : OPERATOR_NAME et OPERATOR_EMAIL : nom à afficher et adresse e-mail du propriétaire de l'opérateur, respectivement.

    • Facultatif : BUSINESS_NAME et BUSINESS_EMAIL, respectivement le nom à afficher et l'adresse e-mail du propriétaire de l'établissement.

Supprimer une application

Avant de pouvoir supprimer une application, vous devez d'abord annuler l'enregistrement de tous les services et charges de travail associés. Ensuite, procédez comme suit pour supprimer l'application :

Console

  1. Sur la page Bienvenue de la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet de gestion ou votre projet hôte :

    Accéder à la page d'accueil

  2. Accédez à la page Applications d'App Hub :

    Accéder à la page Applications

    La page affiche la liste de vos applications.

  3. Cliquez sur le nom de l'application que vous souhaitez supprimer.

  4. Accédez à l'onglet Services et charges de travail et assurez-vous d'avoir annulé l'enregistrement de toutes les ressources associées à l'application. Pour en savoir plus, consultez Désenregistrer des services et des charges de travail.

  5. Une fois tous les services et charges de travail désenregistrés, revenez aux détails de l'application et cliquez sur Supprimer.

gcloud

  1. Trouvez l'ID du projet de votre projet de gestion ou de votre projet hôte.

  2. Assurez-vous d'avoir annulé l'enregistrement de toutes les ressources associées à l'application. Pour en savoir plus, consultez Désenregistrer des services et des charges de travail.

  3. Une fois que l'application n'a plus de ressources enregistrées, supprimez-la :

    gcloud apphub applications delete APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION

    Remplacez les éléments suivants :

    • APPLICATION_NAME : nom de votre application. Vous spécifiez cette valeur lorsque vous créez une application.
    • PROJECT_ID : ID de votre projet hôte ou de gestion.
    • LOCATION : emplacement de votre application. Utilisez global pour les applications mondiales ou une région spécifique, comme us-east1, pour les applications régionales.

Étapes suivantes