Gérer les déploiements

Console

Pour créer un nouveau déploiement, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page API Hub.

   Accéder au hub d'API
2. Cliquez sur API.
3. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
4. Cliquez sur une API pour en afficher les détails.
5. Dans l'onglet Déploiements, cliquez sur Ajouter un déploiement.
6. Spécifiez les détails du déploiement dans le formulaire Créer un déploiement :
   • ID de déploiement : cliquez sur Spécifier un ID unique pour fournir éventuellement un ID unique au déploiement. Si vous omettez l'ID, le hub d'API le crée pour vous. L'ID doit contenir entre 4 et 500 caractères, et les caractères valides sont /[A-Z][a-z][0-9]-/.
   • Nom du déploiement (obligatoire) : indiquez un nom à afficher pour le déploiement.
   • Description : saisissez une description du déploiement.
   • Type de déploiement : sélectionnez le type de déploiement. Les valeurs possibles sont définies dans un attribut système, et vous pouvez les modifier dans la section Gérer les attributs.
   • URI de ressource (obligatoire) : indiquez un URI à la ressource d'exécution. Cet URI peut être utilisé pour gérer la ressource. Par exemple, si la ressource d'exécution est un proxy d'API Apigee, ce champ doit contenir l'URI de l'interface utilisateur de gestion du proxy.
   • Environnement : mappage de l'environnement sur ce déploiement. L'environnement correspond à l'attribut d'environnement défini par le système.
   • Documentation : saisissez un lien vers la documentation du déploiement.
   • SLO : indiquez le SLO pour ce déploiement. Cette valeur correspond à l'attribut de SLO défini par le système. Vous pouvez modifier les valeurs de cet attribut dans Gérer les attributs.
   • Points de terminaison (obligatoire) : indiquez les points de terminaison auxquels cette ressource de déploiement écoute les requêtes API. Il peut s'agir d'une liste complète d'URI, de noms d'hôte ou d'adresses IP.
   • Lien vers une version : associez le déploiement à une ou plusieurs versions de l'API.
   • Attributs définis par l'utilisateur : paires clé/valeur définies par l'utilisateur. Vous pouvez ajouter des attributs définis par l'utilisateur dans Gérer les attributs.
7. Cliquez sur Créer.

REST

Pour ajouter un nouveau déploiement à l'aide de l'API Créer un déploiement, procédez comme suit :

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments?deployment_id=DEPLOYMENT_ID"
  -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X POST -H "Content-Type: application/json" \
  '{
    "display-name": DISPLAY_NAME
    }'

Remplacez les éléments suivants :

• HUB_PROJECT : nom du projet hôte dans API Hub. Le projet hôte a été sélectionné lors du provisionnement du hub d'API.
• HUB_LOCATION : emplacement du projet hôte. L'emplacement a été choisi lors du provisionnement du hub d'API.
• DEPLOYMENT_ID : (facultatif) identifiant du déploiement. S'il n'est pas fourni, un ID généré par le système sera utilisé. Le nom doit être une chaîne de 4 à 500 caractères, dont les caractères valides sont /[a-z][A-Z][0-9]-_/.
• DISPLAY_NAME : (obligatoire) nom à afficher du déploiement. Vous pouvez utiliser n'importe quel nom.
• Attributs facultatifs : en plus du nom à afficher qui est requis, vous pouvez associer des attributs et des entités facultatifs à un déploiement. Ces éléments supplémentaires sont décrits à la section description des ressources de déploiement dans la documentation de référence de l'API REST.

Console

Pour ajouter un déploiement à une version, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page API Hub.

   Accéder au hub d'API
2. Cliquez sur API.
3. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
4. Sélectionnez une API.
5. Dans le tableau Versions, localisez la version que vous souhaitez modifier.
6. Sélectionnez Modifier dans le menu "Actions" à droite de la ligne de la version, ou sélectionnez la version et cliquez sur Modifier la version sur la page d'informations.
7. Sous Lien vers un déploiement, sélectionnez un ou plusieurs déploiements à associer à la version, puis cliquez sur OK.
8. Cliquez sur Enregistrer.

REST

Exemple d'ajout d'un déploiement à une version :

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_NAME/versions/VERSION_ID"
  -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X PATCH -H "Content-Type: application/json" \
  '{
    "deployments": "DEPLOYMENTS"
  }'

Remplacez les éléments suivants :

• HUB_PROJECT : nom du projet hôte dans API Hub. Le projet hôte a été sélectionné lors du provisionnement du hub d'API.
• HUB_LOCATION : emplacement du projet hôte. L'emplacement a été choisi lors du provisionnement d'API Hub.
• API_NAME : nom de l'API possédant la version que vous souhaitez modifier.
• VERSION_ID : ID unique de la version à modifier.
• DEPLOYMENTS : nom de ressource complet d'un ou de plusieurs déploiements. Exemple : "projects/myproject/locations/us-central1/deployments/mydeployment-1, projects/myproject/locations/us-central1/deployments/mydeployment-2"

Console

Pour lister les déploiements avec l'interface utilisateur, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page API Hub.

   Accéder au hub d'API
2. Cliquez sur API.
3. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
4. Cliquez sur une API pour en afficher les détails.
5. Sélectionnez l'onglet Déploiements pour répertorier tous les déploiements associés à l'API.
6. Dans l'onglet Versions, sélectionnez une version si vous souhaitez afficher les déploiements associés à cette version.

REST

Pour répertorier tous les déploiements, utilisez l'API Répertorier les déploiements :

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments"
        -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X GET -H "Content-Type: application/json"

Remplacez les éléments suivants :

• HUB_PROJECT : nom du projet hôte dans API Hub. Le projet hôte a été sélectionné lors du provisionnement du hub d'API.
• HUB_LOCATION : emplacement du projet hôte. L'emplacement a été choisi lors du provisionnement du hub d'API.

Console

Pour afficher les détails d'un déploiement, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page API Hub.

   Accéder au hub d'API
2. Cliquez sur API.
3. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
4. Cliquez sur une API pour en afficher les détails.
5. Sélectionnez l'onglet Déploiements pour répertorier tous les déploiements associés à l'API.
6. Sélectionnez le déploiement pour afficher sa page d'informations.

REST

Pour afficher les détails d'un déploiement, utilisez l'API Obtenir les détails du déploiement :

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments/DEPLOYMENT_ID"
    -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X GET -H "Content-Type: application/json"

Remplacez les éléments suivants :

• HUB_PROJECT : nom du projet hôte dans API Hub. Le projet hôte a été sélectionné lors du provisionnement du hub d'API.
• HUB_LOCATION : emplacement du projet hôte. L'emplacement a été choisi lors du provisionnement du hub d'API.
• DEPLOYMENT_ID : ID unique du déploiement.

Console

Pour supprimer un déploiement avec l'interface utilisateur :

1. Dans la console Google Cloud, accédez à la page API Hub.

   Accéder au hub d'API
2. Cliquez sur API.
3. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
4. Cliquez sur une API pour en afficher les détails.
5. Sélectionnez l'onglet Déploiements pour répertorier tous les déploiements associés à l'API.
6. Localisez le déploiement que vous souhaitez supprimer.
7. Sélectionnez Supprimer dans le menu Action du déploiement.

REST

Pour supprimer un déploiement du hub d'API, utilisez l'API Supprimer le déploiement :

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments/DEPLOYMENT_ID"
    -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X DELETE -H "Content-Type: application/json"

Remplacez les éléments suivants :

• HUB_PROJECT : nom du projet hôte dans API Hub. Le projet hôte a été sélectionné lors du provisionnement du hub d'API.
• HUB_LOCATION : emplacement du projet hôte. L'emplacement a été choisi lors du provisionnement du hub d'API.
• DEPLOYMENT_ID : ID unique du déploiement à supprimer.

Console

Pour dissocier un déploiement d'une API à l'aide de l'interface utilisateur :

1. Dans la console Google Cloud, accédez à la page API Hub.

   Accéder au hub d'API
2. Cliquez sur API.
3. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
4. Cliquez sur une API pour en afficher les détails.
5. Sélectionnez l'onglet Déploiements pour répertorier tous les déploiements associés à l'API.
6. Recherchez le déploiement que vous souhaitez dissocier.
7. Sélectionnez Dissocier de l'API dans le menu Action du déploiement.

Pour dissocier un déploiement d'une version avec l'interface utilisateur :

1. Dans la console Google Cloud, accédez à la page API Hub.

   Accéder au hub d'API
2. Cliquez sur API.
3. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
4. Cliquez sur une API pour en afficher les détails.
5. Sélectionnez une version.
6. Dans la section Déploiements, recherchez le déploiement que vous souhaitez dissocier.
7. Sélectionnez Dissocier de la version dans le menu Action du déploiement.

REST

Pour supprimer une ressource d'API du hub d'API, utilisez l'API Supprimer le déploiement :

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments/DEPLOYMENT_ID"
    -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X DELETE -H "Content-Type: application/json"

Remplacez les éléments suivants :

• HUB_PROJECT : nom du projet hôte dans API Hub. Le projet hôte a été sélectionné lors du provisionnement du hub d'API.
• HUB_LOCATION : emplacement du projet hôte. L'emplacement a été choisi lors du provisionnement du hub d'API.
• DEPLOYMENT_ID : ID unique du déploiement à supprimer.

Console

1. Dans la console Google Cloud, accédez à la page API Hub.

   Accéder au hub d'API
2. Cliquez sur API.
3. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
4. Cliquez sur une API pour en afficher les détails.
5. Sélectionnez l'onglet Déploiements pour répertorier tous les déploiements associés à l'API.
6. Localisez le déploiement que vous souhaitez modifier.
7. Sélectionnez Modifier dans le menu Action du déploiement, ou cliquez sur le déploiement, puis sur Modifier le déploiement dans le panneau "Détails du déploiement".

REST

Pour modifier un déploiement, utilisez l'API Appliquer un correctif au déploiement :

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments/DEPLOYMENT_ID"
      -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X PATCH -H "Content-Type: application/json"
      '{
        DEPLOYMENT_ATTRIBUTES
      {'

Remplacez les éléments suivants :

• HUB_PROJECT : nom du projet hôte dans API Hub. Le projet hôte a été sélectionné lors du provisionnement du hub d'API.
• HUB_LOCATION : emplacement du projet hôte. L'emplacement a été choisi lors du provisionnement du hub d'API.
• DEPLOYMENT_ID : ID unique du déploiement à modifier.
• DEPLOYMENT_ATTRIBUTES : joignez les attributs que vous souhaitez modifier dans le corps de la requête. Les attributs modifiables sont décrits dans la description des ressources de déploiement dans la documentation de référence de l'API REST.