Enregistrer des ressources existantes dans une application

En enregistrant vos services et charges de travail existants dans une application, vous pouvez simplifier la gestion en organisant les ressources en fonction de leur objectif commercial. Cette approche offre une visibilité, une surveillance, une gouvernance et un contrôle opérationnel unifiés.

Ce guide vous explique comment regrouper les services et les charges de travail existants exécutés dansGoogle Cloud qui ne sont pas encore formellement définis comme une application.

Avant de commencer

Vous devez effectuer la configuration initiale de la gestion des applications avant d'organiser les ressources dans des applications. Ce processus implique généralement les rôles et étapes suivants :

  • Pour les administrateurs :

    1. Configurer la gestion des applications Configurez un dossier compatible avec les applications ou un projet hôte pour qu'ils servent de limite administrative pour vos applications.
    2. Activez les API requises. Activez les API pour toutes les ressources que vous prévoyez d'utiliser.
    3. Accorder un accès aux utilisateurs Attribuez les rôles IAM appropriés en fonction des responsabilités de l'utilisateur dans le cycle de vie de l'application.

  • Pour les développeurs et les opérateurs :

    1. Vérifiez auprès de votre administrateur que la configuration initiale est terminée.
    2. Assurez-vous de disposer des rôles IAM nécessaires pour les tâches que vous souhaitez effectuer.
    3. Ouvrez le dossier ou le projet hôte compatible avec les applications, selon votre modèle de configuration.

Créer une application

Créez une application dans App Hub pour qu'elle serve de conteneur logique pour vos services et charges de travail existants :

Console

  1. Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet hôte ou le projet de gestion du dossier dans lequel les applications sont activées, en fonction de votre modèle de configuration.

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

    Accéder à la page Applications

  3. Cliquez sur Créer une application.

  4. Dans le volet Choisir la région et le nom de l'application, sélectionnez l'emplacement le plus adapté à votre application en fonction de vos exigences de répartition géographique :

    • Sélectionnez Régionale pour créer une application régionale. Sélectionnez ensuite la région spécifique de votre application en fonction des régions compatibles avec le hub d'applications.
    • Sélectionnez Global pour créer une application globale.

    Pour en savoir plus sur le meilleur emplacement pour votre application, consultez Applications mondiales et régionales.

  5. Saisissez le nom de l'application, puis cliquez sur Continuer.

  6. Facultatif : Définissez les attributs de premier niveau de l'application pour faciliter la découverte et la gouvernance :

    • Dans la section Ajouter des attributs, saisissez le nom à afficher.
    • Dans la liste Criticité, sélectionnez une valeur pour indiquer l'importance de l'application.
    • Dans la liste Environnement, sélectionnez une valeur pour indiquer l'étape du cycle de vie du logiciel.
    • Ajoutez les coordonnées des propriétaires, y compris leur nom à afficher et leur adresse e-mail. Notez que les adresses e-mail doivent être au format username@yourdomain, par exemple jane-doe@gmail.com.

  7. Cliquez sur Créer.

gcloud

  1. Utilisez Google Cloud CLI pour créer une application depuis votre terminal ou Cloud Shell :

    gcloud apphub applications create APPLICATION_NAME \
  --project=PROJECT_ID \
  --scope-type=LOCATION \
  --location=REGION \
  --display-name=DISPLAY_NAME \
  --criticality-type=CRITICALITY \
  --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 APPLICATION_NAME par le nom de votre application. Le nom ne doit contenir que des caractères alphanumériques en minuscules, sans espaces.

    Utilisez des indicateurs facultatifs tels que --criticality-type pour définir les attributs de premier niveau de l'application et favoriser la détectabilité et la gouvernance.

    Pour les indicateurs obligatoires et facultatifs, remplacez les éléments suivants :

    • Obligatoire : PROJECT_ID : ID du projet hôte ou du projet de gestion, selon votre modèle de configuration.

    • Obligatoire : LOCATION : emplacement de votre application en fonction de vos exigences de distribution géographique. Utilisez l'une des valeurs suivantes :

      • REGIONAL pour les applications régionales.
      • GLOBAL pour les applications globales.

      Pour en savoir plus sur le meilleur emplacement pour votre application, consultez Applications mondiales et régionales.

    • Obligatoire : REGION, la région spécifique de votre application. Appliquez l'une des valeurs suivantes :

      • Si l'emplacement --scope-type de votre application est défini sur REGIONAL, spécifiez le nom d'une région compatible avec App Hub.
      • Si l'emplacement --scope-type de votre application est défini sur GLOBAL, utilisez global.

    • Facultatif : DISPLAY_NAME : nom à afficher de votre application.

    • Facultatif : CRITICALITY, niveau d'importance de l'application pour vos opérations. Utilisez 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.

  2. Répertoriez les applications de votre projet :

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

    Vous devez obtenir un résultat semblable à celui-ci :

    ID                 DISPLAY_NAME   CREATE_TIME
APPLICATION_NAME   DISPLAY_NAME   2023-10-31T18:33:48

Enregistrer des services et des charges de travail

Après avoir créé une application, enregistrez-y vos services et charges de travail existants :

Console

  1. Dans la console Google Cloud , utilisez le sélecteur de projet pour sélectionner votre projet hôte ou le projet de gestion du dossier dans lequel les applications sont activées, en fonction de votre modèle de configuration.

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

    Accéder à la page Applications

  3. Cliquez sur le nom de l'application pour laquelle vous souhaitez enregistrer des services et des charges de travail existants.

  4. Sur la page d'informations de l'application, sélectionnez l'onglet Services et charges de travail. Cet onglet affiche la liste des ressources existantes que vous pouvez enregistrer dans l'application. App Hub vous permet de sélectionner des ressources compatibles situées dans votre hiérarchie de ressources en tant que services et charges de travail.

  5. Pour chaque service ou charge de travail que vous souhaitez enregistrer, procédez comme suit :

    1. Dans l'onglet Services et charges de travail, cliquez sur Enregistrer un service/une charge de travail.
    2. Accédez au volet Sélectionner une ressource, puis cliquez sur Parcourir pour trouver le service ou la charge de travail que vous souhaitez enregistrer.
    3. Sélectionnez le service ou la charge de travail, puis cliquez sur Sélectionner.
    4. Dans le volet Sélectionner une ressource, saisissez un nom pour le service ou la charge de travail, puis cliquez sur Continuer.

    5. Facultatif : Dans le volet Ajouter des attributs, définissez les attributs de premier niveau de la ressource pour faciliter la découverte et la gouvernance.

    6. Cliquez sur Continuer.

    7. Facultatif : Dans la section Ajouter des propriétaires, ajoutez des informations sur les propriétaires du service ou de la charge de travail.

    8. Cliquez sur S'inscrire.

L'onglet Services et charges de travail affiche le service ou la charge de travail enregistrés.

gcloud

App Hub vous permet de sélectionner des ressources compatibles situées dans votre hiérarchie de ressources en tant que services et charges de travail. Utilisez Google Cloud CLI pour lister les services ou les charges de travail que vous pouvez enregistrer dans l'application depuis votre terminal ou Cloud Shell. Les commandes sont légèrement différentes pour les services et les charges de travail :

Enregistrer les services

  1. Répertoriez les services disponibles que vous pouvez enregistrer dans une application :

    gcloud apphub discovered-services list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter=FILTER_EXPRESSION

    Pour les indicateurs obligatoires et facultatifs, remplacez les éléments suivants :

    • Obligatoire : PROJECT_ID : ID du projet hôte ou du projet de gestion, selon votre modèle de configuration.

    • Obligatoire : REGION : région spécifique de votre service en fonction de votre répartition géographique. Utilisez l'une des valeurs suivantes :

    • Facultatif : FILTER_EXPRESSION : expression de filtre pour l'indicateur --filter afin d'afficher uniquement les services d'un projet spécifié ou avec une propriété spécifique, par exemple :

      • service_properties.gcp_project=projects/PROJECT_ID
      • service_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules"

    Le résultat ressemble à celui de l'exemple ci-dessous.

    ID            SERVICE_REFERENCE                                                                                             SERVICE_PROPERTIES
SERVICE_ID    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}

  2. Copiez l'ID de service, SERVICE_ID, à partir de la sortie.

  3. Enregistrez le service dans votre application :

    gcloud apphub applications services create SERVICE_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --application=APPLICATION_NAME \
  --discovered-service=projects/PROJECT_ID/locations/REGION/discoveredServices/SERVICE_ID \
  --display-name=SERVICE_DISPLAY_NAME \
  --criticality-type=CRITICALITY \
  --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 SERVICE_NAME par le nom que vous souhaitez utiliser pour enregistrer le service auprès de l'application.

    Utilisez des indicateurs facultatifs tels que --criticality-type pour définir les attributs de premier niveau du service et favoriser la détectabilité et la gouvernance.

    Pour les indicateurs obligatoires et facultatifs, remplacez les éléments suivants :

    • Obligatoire : PROJECT_ID : ID du projet hôte ou du projet de gestion, selon votre modèle de configuration.

    • Obligatoire : REGION : région spécifique de votre service en fonction de votre répartition géographique. Utilisez l'une des valeurs suivantes :

    • Obligatoire : APPLICATION_NAME : nom de l'application pour laquelle vous souhaitez enregistrer le service.

    • Obligatoire : SERVICE_ID : ID de service que vous avez copié à partir du résultat précédent.

    • Facultatif : SERVICE_DISPLAY_NAME : nom à afficher de votre service.

    • Facultatif : CRITICALITY : niveau d'importance du service pour vos opérations. Utilisez 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.

  4. Listez les services enregistrés dans votre application :

    gcloud apphub applications services list \
  --application=APPLICATION_NAME
  --project=PROJECT_ID \
  --location=REGION

    Vous devez obtenir un résultat semblable à celui-ci pour chaque service enregistré :

    ID              DISPLAY_NAME            SERVICE_REFERENCE                                                                                             CREATE_TIME
SERVICE_NAME    SERVICE_DISPLAY_NAME    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'}    2023-11-01T21:38:08

Enregistrer des charges de travail

  1. Répertoriez les charges de travail disponibles que vous pouvez enregistrer dans une application :

    gcloud apphub discovered-workloads list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter=FILTER_EXPRESSION

    Pour les indicateurs obligatoires et facultatifs, remplacez les éléments suivants :

    • Obligatoire : PROJECT_ID : ID du projet hôte ou du projet de gestion, selon votre modèle de configuration.

    • Obligatoire : REGION, la région spécifique de votre charge de travail en fonction de votre répartition géographique. Utilisez l'une des valeurs suivantes :

    • FILTER_EXPRESSION (facultatif) : expression de filtre pour l'indicateur --filter afin d'afficher uniquement les charges de travail d'un projet spécifié ou avec une propriété spécifique, par exemple workload_properties.gcp_project=projects/PROJECT_ID.

    Le résultat ressemble à celui de l'exemple ci-dessous.

    ID             WORKLOAD_REFERENCE                                                                                    WORKLOAD_PROPERTIES
WORKLOAD_ID    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}

  2. Copiez l'ID de charge de travail, WORKLOAD_ID, à partir de la sortie.

  3. Enregistrez la charge de travail dans votre application :

    gcloud apphub applications workloads create WORKLOAD_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --application=APPLICATION_NAME \
  --discovered-workload=projects/PROJECT_ID/locations/REGION/discoveredWorkloads/WORKLOAD_ID \
  --display-name=WORKLOAD_DISPLAY_NAME \
  --criticality-type=CRITICALITY \
  --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 WORKLOAD_NAME par le nom que vous souhaitez utiliser pour enregistrer la charge de travail dans l'application.

    Utilisez des indicateurs facultatifs tels que --criticality-type pour définir les attributs de premier niveau de la charge de travail et favoriser la détectabilité et la gouvernance.

    Pour les indicateurs obligatoires et facultatifs, remplacez les éléments suivants :

    • Obligatoire : PROJECT_ID : ID du projet hôte ou du projet de gestion, selon votre modèle de configuration.

    • Obligatoire : REGION, la région spécifique de votre charge de travail en fonction de votre répartition géographique. Utilisez l'une des valeurs suivantes :

    • Obligatoire : APPLICATION_NAME : nom de l'application pour laquelle vous souhaitez enregistrer la charge de travail.

    • Obligatoire : WORKLOAD_ID : ID de charge de travail que vous avez copié à partir du résultat précédent.

    • WORKLOAD_DISPLAY_NAME (facultatif) : nom à afficher de votre charge de travail.

    • Facultatif : CRITICALITY : niveau d'importance de la charge de travail pour vos opérations. Utilisez 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.

  4. Répertoriez les charges de travail enregistrées dans votre application :

    gcloud apphub applications workloads list \
  --application=APPLICATION_NAME
  --project=PROJECT_ID \
  --location=REGION

    Vous devez obtenir un résultat semblable à celui-ci pour chaque charge de travail enregistrée :

    ID               DISPLAY_NAME             WORKLOAD_REFERENCE                                                                                    CREATE_TIME
WORKLOAD_NAME    WORKLOAD_DISPLAY_NAME    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'}    2023-11-01T21:38:08

Accorder des autorisations et commencer les opérations

Après avoir créé une application et enregistré vos ressources dans le hub d'applications, vous accordez l'accès aux utilisateurs en fonction de leurs responsabilités et gérez ce regroupement logique comme une seule unité :

  1. Selon vos besoins d'accès, vous pouvez accorder des autorisations à votre application. Pour obtenir la liste des rôles recommandés, consultez Attribuer des rôles axés sur les applications à vos utilisateurs.
  2. Accédez à Cloud Hub pour afficher un tableau de bord opérationnel unifié pour votre application définie, y compris ses données sur l'état, les performances et les coûts.