Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page décrit comment créer un service et afficher les informations associées.
Les services constituent les ressources principales de Knative serving.
Créer un service
Vous devez créer un service et sa révision en y déployant une image de conteneur pour la première fois. Consultez la section Déployer un nouveau service pour en savoir plus sur la création de services.
Afficher la liste des services de votre projet
Vous pouvez afficher la liste des services disponibles dans votre projet à l'aide de la consoleGoogle Cloud ou de la Google Cloud CLI:
Console
Pour afficher la liste des services, procédez comme suit :
Accédez à Knative serving dans la console Google Cloud :
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 run services list
Vous pouvez filtrer cette liste suivant les propriétés de la définition de service, telles qu'un libellé attribué.
Copier un service
Vous pouvez créer une copie d'un service existant à l'aide de la console ou de YAML. Google Cloud
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 :
Accédez à Knative serving dans la console Google Cloud :
Sélectionnez le service à copier dans la liste des services affichés pour votre projet :
Cliquez sur Copier.
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.
Cliquez sur Create (Créer) pour générer une copie et la déployer sous le nouveau nom du service.
YAML
Vous pouvez télécharger la configuration d'un service existant dans un fichier YAML avec la commande gcloud run services describe à l'aide de l'option --format=export.
Vous pouvez ensuite modifier ce fichier YAML et déployer ces modifications à l'aide de la commande gcloud run services replace.
Veillez à ne modifier que les attributs spécifiés.
Téléchargez la configuration de votre service dans un fichier nommé service.yaml sur l'espace de travail local :
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.
Copiez le service à l'aide de la commande suivante :
gcloudrunservicesreplaceservice.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 :
Accédez à Knative serving dans la console Google Cloud :
Cliquez sur le service souhaité dans la liste des services affichés pour votre projet afin d'ouvrir la vue Détails du service :
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 :
gcloudrunservicesdescribeSERVICE
Remplacez SERVICE par le nom du service.
Vous pouvez utiliser l'option --format pour formater le résultat. Par exemple, au format YAML :
gcloudrunservicesdescribeSERVICE--formatyaml
Vous pouvez utiliser --format export pour exporter au format YAML sans libellés ni états générés automatiquement :
gcloudrunservicesdescribeSERVICE--formatexport
Vous pouvez également utiliser l'option --format pour obtenir l'URL du service :
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 :
Cliquez sur l'onglet Triggers (Déclencheurs).
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 run 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 :
Accédez à Knative serving dans la console Google Cloud :
Recherchez le service que vous souhaitez supprimer dans la liste des services, puis cliquez la case correspondante pour le sélectionner.
Cliquez sur DELETE (SUPPRIMER) pour supprimer toutes les révisions du service.
Ligne de commande
Pour supprimer un service, utilisez la commande suivante :
gcloud run services delete [SERVICE]
Remplacez [SERVICE] par le nom du service.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/01 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/01 (UTC)."],[],[],null,["# Managing services\n\nThis page describes creating a service and viewing information about a service.\nServices are the main resources of Knative serving.\n\nCreating a service\n------------------\n\nYou create a new service and its [revision](/kubernetes-engine/enterprise/knative-serving/docs/managing/revisions) by\ndeploying a container image to it for the first time. See\n[Deploying a new service](/kubernetes-engine/enterprise/knative-serving/docs/deploying#service) to learn more about\ncreating services.\n\nViewing the list of services in your project\n--------------------------------------------\n\nYou can view a list of the available services in your project using\nGoogle Cloud console or the Google Cloud CLI: \n\n### Console\n\nTo view the services list:\n\n1. Go to Knative serving in the Google Cloud console:\n\n [Go to Knative serving](https://console.cloud.google.com/kubernetes/run)\n2. Examine the displayed list of services for your project:\n\n### Command line\n\nTo list the services in your project: \n\n gcloud run services list\n\nYou can filter this list by properties of the service definition, such as an\n[assigned label](/kubernetes-engine/enterprise/knative-serving/docs/configuring/labels#label-listing).\n\nCopying a service\n-----------------\n\nYou can make a copy of an existing service using Google Cloud console or YAML.\nYou can change anything you want in the copy, including name and region. \n\n### Console\n\nTo copy a service:\n\n1. Go to Knative serving in the Google Cloud console:\n\n [Go to Knative serving](https://console.cloud.google.com/kubernetes/run)\n2. Select the service to copy from the displayed list of services for your\n project:\n\n 1. Click **Copy**.\n\n 2. In the service copy page, set or change any values you want to change,\n such as region, etc. If you are keeping the same region, you must provide a\n new name for the service.\n\n 3. Click **Create** to make a copy and deploy it using the new service\n name.\n\n### YAML\n\n| **Caution:** Deploying configuration changes using YAML files replaces the configuration of your existing services. Since a YAML file completely overwrites all configurations, you should avoid using multiple methods to modify your services. For example, do not use YAML files in conjunction with the Google Cloud console or `gcloud` commands.\n\nYou can download the configuration of an existing service into a\nYAML file with the `gcloud run services describe` command by using the\n[`--format=export`](/sdk/gcloud/reference/run/services/describe) flag.\nYou can then modify that YAML file and deploy\nthose changes with the `gcloud run services replace` command.\nYou must ensure that you modify only the specified attributes.\n\n1. Download the configuration of your service into a file named\n `service.yaml` on local workspace:\n\n ```bash\n gcloud run services describe SERVICE --format export \u003e service.yaml\n ```\n\n Replace \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name of your\n Knative serving service.\n2. Make any desired configuration changes to the service as described in the\n various [configuration pages](/kubernetes-engine/enterprise/knative-serving/docs/how-to#configure).\n\n apiVersion: serving.knative.dev/v1\n kind: Service\n metadata:\n annotations:\n ...\n name: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eSERVICE\u003c/span\u003e\u003c/var\u003e\n ...\n spec:\n template:\n metadata:\n annotations:\n ...\n name: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eREVISION-NAME\u003c/span\u003e\u003c/var\u003e\n\n - If you are deploying the copy to the same Kubernetes cluster, replace\n \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name you want to use for the copy. If you are\n deploying the copy to a different Kubernetes cluster, you can use the\n same name.\n\n - Make sure the value for \u003cvar translate=\"no\"\u003eREVISION-NAME\u003c/var\u003e starts with the service\n name (\u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e). For example, if the new service name is\n `mynewfoo`, then the revision name must be in the format `mynewfoo-whatever`.\n Optionally delete the value altogether and a new revision name is created\n automatically.\n\n3. Copy the service using the following command:\n\n ```bash\n gcloud run services replace service.yaml\n ```\n\n Use the [`--region`](/sdk/gcloud/reference/run/services/replace#--region)\n flag to deploy the copy to a different region.\n\nViewing more details about a service\n------------------------------------\n\nTo see more details about a service, \n\n### Console\n\nTo view a service's details:\n\n1. Go to Knative serving in the Google Cloud console:\n\n [Go to Knative serving](https://console.cloud.google.com/kubernetes/run)\n2. Click on the desired service in the displayed list of services for your\n project to open the service details view:\n\n3. Note the **REVISIONS** , **LOGS** and **DETAILS** tabs. The revisions tab\n shows the list of revisions, the logs tab shows the [service logs](/kubernetes-engine/enterprise/knative-serving/docs/logging),\n and the details tab shows the current\n [authentication](/kubernetes-engine/enterprise/knative-serving/docs/deploying#service) or\n [connectivity](#connectivity) settings.\n\n### Command line\n\nTo view details about a service: \n\n```bash\ngcloud run services describe SERVICE\n```\nReplace \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name of the service.\n\n\u003cbr /\u003e\n\nYou can use the [`--format` flag](/sdk/gcloud/reference#--format) to format\nthe output. For example as YAML: \n\n```bash\ngcloud run services describe SERVICE --format yaml\n```\n\nYou can use `--format export` to export as YAML without automatically\ngenerated labels or status: \n\n```bash\ngcloud run services describe SERVICE --format export\n```\n\nYou can also use the [`--format` flag](/sdk/gcloud/reference#--format) to get\nthe URL of the service: \n\n```bash\ngcloud run services describe SERVICE --format='value(status.url)'\n```\n\n\u003cbr /\u003e\n\nFor details about the revisions of a service, see\n[Managing Revisions](/kubernetes-engine/enterprise/knative-serving/docs/managing/revisions).\n\nChanging service connectivity settings\n--------------------------------------\n\nA Knative serving service can have either of two connection options:\n\n- *external*, which allows external access to your service\n\n- *internal* which restricts access only to other services in your cluster.\n\nYou can use the console or the Google Cloud CLI to change the settings. \n\n### Console\n\nTo change service connectivity settings:\n\n1. Go to Knative serving in the Google Cloud console:\n\n [Go to Knative serving](https://console.cloud.google.com/kubernetes/run)\n2. Click on the desired service in the displayed list of services for your\n project to open the service details view.\n\n3. Click the **Triggers** tab.\n\n4. Select the desired setting and click **Save**.\n\n### Command line\n\nTo change service connectivity settings, update the service with the desired\nconnectivity setting: \n\n gcloud run services update [SERVICE] --connectivity=[OPTION]\n\n- Replace `[SERVICE]` with the name of the service you are updating.\n You can omit this parameter entirely, but you will be prompted for the\n service name if you omit it.\n\n- Replace `[OPTION]` with `internal` or `external`.\n\nDeleting existing services\n--------------------------\n\nDeleting a service deletes all resources related to this service, including all\nrevisions of this service whether they are serving traffic or not.\n\nWhen deleting a service, the container images used by the deleted revisions are not\ndeleted automatically from Container Registry. To delete container images from\nContainer Registry see [Deleting images](/container-registry/docs/managing#deleting_images).\n\nNote that deleting a service is permanent: there is no undo or restore.\nHowever, if after deleting a service, you deploy a new service with the same\nname in the same cluster, it will have the same endpoint URL. \n\n### Console\n\nTo delete a service:\n\n1. Go to Knative serving in the Google Cloud console:\n\n [Go to Knative serving](https://console.cloud.google.com/kubernetes/run)\n2. Locate the service you want to delete in the services list, and click\n its checkbox to select it.\n\n3. Click **DELETE**. This deletes all revisions of the service.\n\n### Command line\n\nTo delete a service, use the command: \n\n gcloud run services delete [SERVICE]\n\nReplace `[SERVICE]` with the name of your service."]]
