Gérer les cycles de vie des services

Cette page explique comment gérer les cycles de vie services gérés via la Google Cloud CLI gcloud endpoints services commandes.

Pour les cas d'utilisation avancés, vous pouvez exploiter l'API Service Management afin de gérer les services de manière automatisée. Pour en savoir plus, consultez la page Premiers pas avec l'API Service Management.

Présentation

Un service géré est une ressource simple qui fournit une représentation logique d'un service intégré à Service Infrastructure, tel que l'API Gmail et l'API Spanner. Un service géré proprement dit ne comporte que deux propriétés immuables, un nom de service et un projet producteur, mais la mise en œuvre d'un service géré peut fournir un large éventail de fonctionnalités. Par exemple, l'API Cloud Storage fournit un service de stockage d'objets à l'échelle mondiale pour des millions de développeurs et d'entreprises.

Un service géré comprend un ensemble de clients du service, un historique des configurations du service immuables, ainsi qu'un historique des déploiements de service immuables. Les configurations de service référencées par le dernier déploiement représentent l'état actuel du service, qui couvre tous ses aspects, allant du nom à afficher aux définitions de métriques en passant par les limites de débit. Pour consulter la spécification, reportez-vous à la page google.api.Service.

Cette page vous explique comment créer et gérer les cycles de vie de vos services. Pour en savoir plus sur la gestion des services, consultez les guides d'utilisation.

Créer un service

Pour créer un service, vous devez effectuer les étapes suivantes.

  1. Installez et initialisez la gcloud CLI sur votre ordinateur.

  2. Créez un projet producteur dédié à l'hébergement de votre service. Un projet dédié représente la meilleure option de sécurité et d'isolation pour votre service. Cela vous permet également de transférer la propriété de votre service à une autre équipe ou même à une autre entreprise.

  3. Activez l'API Service Management et l'API Service Control pour votre projet.

  4. Activez Cloud Billing pour votre projet. Pour intégrer votre service à Service Infrastructure, vous aurez besoin de plusieurs produits Google Cloud payants, y compris l'API Service Control, l'API Cloud Logging et l'API Cloud Monitoring.

  5. Préparez un fichier de configuration yaml simple pour votre service selon le modèle suivant :

    # Filename: endpointsapis.yaml
    type: google.api.Service
    config_version: 3
    # Update the next line to use your own service name.
    name: endpointsapis.appspot.com
    # Update the next line to use your own producer project id.
    producer_project_id: endpointsapis
    
  6. Exécutez la commande gcloud pour créer votre service en déployant une configuration de service vide :

    gcloud endpoints services deploy endpointsapis.yaml
    

Le processus de création du service prend environ une minute. Après cela, vous devriez être votre service figure dans la liste Page Points de terminaison dans la console Google Cloud.

Répertorier les services

Pour répertorier les services d'un projet, vous pouvez utiliser la commande suivante :

gcloud endpoints services list --project endpointsapis

Décrire un service

Pour décrire un service et sa configuration, vous pouvez utiliser la commande suivante :

gcloud endpoints services describe endpointsapis.appspot.com

Supprimer un service

Si vous n'avez plus besoin d'un service, vous pouvez le supprimer à l'aide de la commande suivante :

gcloud endpoints services delete endpointsapis.appspot.com

REMARQUE : Chaque service se voit appliquer un délai de conservation obligatoire de 30 jours en cas de suppression.

Annuler la suppression d'un service

Au cours du délai de conservation après suppression d'un service, vous pouvez annuler cette suppression à l'aide de la commande suivante :

gcloud endpoints services undelete endpointsapis.appspot.com

Étapes suivantes

L'API Service Management utilise un modèle déclaratif pour la gestion des services. Une fois le service créé, vous devez transférer des configurations de service immuables et des déploiements de services immuables pour atteindre l'état souhaité pour le service. Vos configurations de service sont utilisées pour configurer les services d'infrastructure Google Cloud, y compris Cloud Billing, Cloud Logging, Cloud Monitoring et Identity and Access Management.

Pour en savoir plus sur les configurations de service, consultez la page Gérer les configurations de service. Pour en savoir plus sur les déploiements de service, consultez la page Gérer les déploiements de service.