Gérer les services

Cette page décrit comment créer un service et afficher les informations associées. Les services constituent les ressources principales de Cloud Run pour Anthos sur Google Cloud.

Créer un service

Vous créez un service en y déployant une image de conteneur pour la première fois. Pour obtenir davantage d'instructions, consultez la page Déployer un nouveau service.

Afficher la liste des services de votre projet

Vous pouvez afficher la liste des services disponibles dans votre projet à l'aide de Cloud Console ou de l'outil de ligne de commande gcloud :

Console

Pour afficher la liste des services, procédez comme suit :

1. Accédez à Cloud Run for Anthos sur Google Cloud.

2. Examinez la liste des services affichés pour votre projet :

   

Ligne de commande

Pour afficher la liste des services de votre projet, procédez comme suit :

gcloud kuberun core services list

Vous pouvez filtrer cette liste suivant les propriétés de la définition de service, telles qu'un libellé attribué.

Cloud Code

Pour afficher la liste des services avec Cloud Code, consultez les guides de l'explorateur Cloud Run pour IntelliJ et Visual Studio Code.

Copier un service

Vous pouvez créer une copie d'un service existant à l'aide de Cloud Console ou de YAML. Vous pouvez modifier n'importe quel élément dans la copie, y compris le nom et la région.

Console

Pour copier un service, procédez comme suit :

1. Accédez à Cloud Run for Anthos sur Google Cloud.

2. Sélectionnez le service à copier dans la liste des services affichés pour votre projet :

   

   1. Cliquez sur Copy (Copier).

   2. Sur la page de copie du service, définissez ou modifiez les valeurs que vous souhaitez changer, par exemple la région. Si vous conservez la même région, vous devez définir un nouveau nom de service.

   3. Cliquez sur Create (Créer) pour générer une copie et la déployer sous le nouveau nom du service.

YAML

Attention : Le déploiement des modifications de configuration à l'aide de fichiers YAML remplace la configuration de vos services existants. Étant donné qu'un fichier YAML écrase complètement toutes les configurations, vous devez éviter d'utiliser plusieurs méthodes pour modifier vos services. Par exemple, n'utilisez pas de fichiers YAML conjointement avec les commandes Cloud Console ou gcloud.

Pour utiliser un fichier YAML afin de modifier la configuration de votre service existant, vous devez obtenir une copie de la configuration actuelle, modifier et enregistrer vos modifications dans un fichier local, puis déployer ces modifications dans votre service.

1. Affichez en YAML puis copiez la configuration de votre service dans un fichier local, par exemple service.yaml :

   gcloud kuberun core services describe SERVICE --format yaml

   Remplacez SERVICE par le nom de votre service Cloud Run pour Anthos.

2. Apportez toutes les modifications souhaitées à la configuration du service, comme décrit dans les différentes pages de configuration.

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      annotations:
        ...
      name: SERVICE
      ...
    spec:
      template:
        metadata:
          annotations:
          ...
          name: REVISION-NAME
   

   • Si vous déployez la copie sur le même cluster Kubernetes, remplacez SERVICE par le nom que vous souhaitez utiliser pour la copie. Si vous déployez la copie sur un autre cluster Kubernetes, vous pouvez utiliser le même nom.

   • Assurez-vous que la valeur de REVISION-NAME commence par le nom du service (SERVICE). Par exemple, si le nouveau nom de service est mynewfoo, le nom de la révision doit suivre le format mynewfoo-whatever. Vous pouvez aussi supprimer entièrement la valeur : un nouveau nom de révision est alors créé automatiquement.

3. Copiez le service à l'aide de la commande suivante :

   gcloud beta run services replace service.yaml

   Utilisez l'option --region pour déployer la copie dans une autre région.

Afficher plus de détails sur un service

Pour afficher davantage de détails sur un service, procédez comme suit :

Console

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

1. Accédez à Cloud Run for Anthos sur Google Cloud.

2. Cliquez sur le service souhaité dans la liste des services affichés pour votre projet afin d'ouvrir la vue Détails du service :

   

3. Notez les onglets REVISIONS (RÉVISIONS), LOGS (JOURNAUX) et DETAILS (DÉTAILS). L'onglet "Revisions" (Révisions) affiche la liste des révisions, l'onglet "Logs" (Journaux) affiche les journaux du service et l'onglet "Details" (Détails) affiche les paramètres d'authentification ou de connectivité actuels.

Ligne de commande

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

gcloud kuberun core services describe SERVICE

Remplacez SERVICE par le nom du service.

Vous pouvez utiliser l'option --format pour formater le résultat. Par exemple, au format YAML :

gcloud kuberun core services describe SERVICE --format yaml

Vous pouvez également utiliser l'option --format pour obtenir l'URL du service :

gcloud kuberun core services describe SERVICE --format='value(status.url)'

Cloud Code

Pour afficher les détails d'un service avec Cloud Code, consultez les guides de l'explorateur Cloud Run pour IntelliJ et Visual Studio Code

Pour en savoir plus sur les révisions de services, consultez la page Gérer les révisions.

Modifier les paramètres de connectivité du service

Un service Cloud Run for Anthos sur Google Cloud peut avoir l'une des deux options de connexion suivantes :

• Externe, ce qui permet un accès externe à votre service

• Interne, ce qui limite l'accès aux autres services Cloud Run for Anthos sur Google Cloud ou aux services de votre cluster qui utilisent Istio.

Vous pouvez modifier les paramètres à l'aide de la console ou de l'outil de ligne de commande gcloud.

Console

Pour modifier les paramètres de connectivité d'un service, procédez comme suit :

1. Accédez à Cloud Run for Anthos sur Google Cloud.

2. Cliquez sur le service souhaité dans la liste des services affichée pour votre projet afin d'ouvrir la vue DETAILS (Détails) du service :

3. Cliquez sur l'onglet Triggers (Déclencheurs).

4. Sélectionnez le paramètre souhaité et cliquez sur Save (Enregistrer).

Ligne de commande

Pour modifier les paramètres de connectivité d'un service, mettez à jour ce service avec le paramètre de connectivité souhaité :

gcloud kuberun core services update [SERVICE] --connectivity=[OPTION]

• Remplacez [SERVICE] par le nom du service que vous mettez à jour. Vous pouvez omettre ce paramètre, mais dans ce cas, le nom du service vous sera demandé.

• Remplacez [OPTION] par internal ou external.

Supprimer des services

La suppression d'un service supprime toutes les ressources associées à ce service, y compris toutes les révisions de ce service, qu'elles diffusent du trafic ou non.

Lors de la suppression d'un service, les images de conteneurs utilisées par les révisions supprimées ne sont pas automatiquement supprimées de Container Registry. Pour supprimer des images de conteneurs de Container Registry, consultez la page Supprimer des images.

Sachez que la suppression d'un service est irréversible : il n'y a aucune possibilité d'annulation ni de restauration. Toutefois, si après avoir supprimé un service, vous déployez un nouveau service portant le même nom dans le même cluster, celui-ci possédera la même URL de point de terminaison.

Console

Pour supprimer un service, procédez comme suit :

1. Accédez à Cloud Run for Anthos sur Google Cloud.

2. Recherchez le service que vous souhaitez supprimer dans la liste des services, puis cliquez la case correspondante pour le sélectionner.

3. Cliquez sur DELETE (SUPPRIMER) pour supprimer toutes les révisions du service.

Ligne de commande

Pour supprimer un service, utilisez la commande suivante :

gcloud kuberun core services delete [SERVICE]

Remplacez [SERVICE] par le nom du service.