Publication et dépublication d'un service de chemin privé

After you verify a successful connexion à votre service de voie privée, you must publish your service for deployment to consumers.

Si un service de chemin privé n'est pas publié, il n'est pas accessible en dehors du compte.

L'édition permet à tout compte de demander l'accès au service Private Path. Si nécessaire, vous pouvez également dépublier lorsque l'accès est limité au compte qui a créé le service Private Path.

Vous pouvez publier et dépublier un service IBM Cloud® Private Path à l'aide de la console, du CLI, de l'API ou de Terraform.

Publication d'un service de chemin privé dans la console

Pour publier un service Private Path dans la console IBM Cloud, procédez comme suit :

  1. Dans votre navigateur, ouvrez la console IBM Cloud et connectez-vous à votre compte.

  2. Sélectionnez l' icône du menu de navigation, puis cliquez sur l'icône Infrastructure VPC > Réseau > Services de chemin privé.

  3. Localisez le nom de votre nouveau service de chemin privé dans le tableau et cliquez sur le nom pour afficher la page des détails du service de chemin privé.

  4. Cliquez sur Publier dans le menu Actions Menu Actions.

    La colonne Publication du tableau Services de chemins privés pour VPC devient Published.

Le service de chemin privé est désormais exposé pour que d'autres comptes se connectent au service via des passerelles VPE (Virtual Private Endpoint).

Après la publication, le nom du service Private Path est visible par les clients qui se connectent au service Private Path.

Dépublier un service de chemin privé dans la console

Pour dépublier un service Private Path dans la console IBM Cloud, procédez comme suit :

  1. Dans votre navigateur, ouvrez la console IBM Cloud et connectez-vous à votre compte.
  2. Sélectionnez l' icône Menu Navigation, puis cliquez sur Infrastructure > Réseau > Services de chemin privé.
  3. Dans le tableau Services de chemin privé pour VPC, localisez le chemin privé que vous souhaitez dépublier, puis cliquez sur le nom de ce service de chemin privé.
  4. Sur la page de détails du service Private Path, cliquez sur le menu Actions, puis sur Dépublier.
  5. Confirmez que vous souhaitez dépublier votre service Private Path.

Publication d'un service de chemin privé à partir de l'interface de programmation

L'exemple suivant montre comment utiliser l'interface de ligne de commande pour publier un service de chemin privé.

Avant de commencer, assurez-vous de configurer votre environnement d'interface de ligne de commande (CLI).

Pour publier un service de chemin privé à partir de l'interface de ligne de commande, procédez comme suit:

  1. Entrez la commande suivante :
ibmcloud is private-path-service-gateway-publish PRIVATE_PATH_SERVICE_GATEWAY
    [--output JSON]
    [-f, --force]
    [-q, --quiet]

Où :

PRIVATE_PATH_SERVICE_GATEWAY
Indique l'ID ou le nom du service de chemin privé.
--output
Indique le format de sortie, seul JSON est pris en charge. Un parmi : JSON.
-q, --quiet
Supprime la sortie prolixe.

Exemples de commande

  • Publier un service de chemin privé : ibmcloud is ppsgp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 ibmcloud is private-path-service-gateway-publish cli-ppsg-0

Dépublier un service de chemin privé à partir de l'interface de ligne de commande

L'exemple suivant montre comment utiliser la CLI pour dépublier un service Private Path.

Avant de commencer, assurez-vous de configurer votre environnement d'interface de ligne de commande (CLI).

Pour dépublier un service de chemin privé à partir de l'interface de ligne de commande, procédez comme suit :

  1. Entrez la commande suivante :
ibmcloud is private-path-service-gateway-unpublish PRIVATE_PATH_SERVICE_GATEWAY
    [--output JSON]
    [-f, --force]
    [-q, --quiet]

Où :

PRIVATE_PATH_SERVICE_GATEWAY
Indique l'ID ou le nom du service de chemin privé.
--output
Indique le format de sortie, seul JSON est pris en charge. Un parmi : JSON.
-q, --quiet
Supprime la sortie prolixe.

Publication d'un service de chemin privé avec l'API

Pour publier un service de chemin privé avec l'API, procédez comme suit:

  1. Configurez votre environnement d'API.

  2. Stockez les valeurs suivantes dans les variables destinées à être utilisées dans la commande d'API :

    • ppsgId-Obtenez votre service de chemin privé, puis renseignez la variable:

      export ppsgId=<your_ppsg_id>
      
  3. Lorsque toutes les variables sont initialisées, publiez votre service Private Path :

    curl -X POST -sH "Authorization:${iam_token}" \
    "$vpc_api_endpoint/v1/private_path_service_gateways/$ppsgId/publish?version=$api_version&generation=2" \
    -d {}'
    

Dépublier un service de chemin privé avec l'API

Pour dépublier un service de chemin privé avec l'API, procédez comme suit :

  1. Configurez votre environnement d'API.

  2. Stockez les valeurs suivantes dans les variables destinées à être utilisées dans la commande d'API :

    • ppsgId-Obtenez votre service de chemin privé, puis renseignez la variable:

      export ppsgId=<your_ppsg_id>
      
  3. Lorsque toutes les variables sont initiées, dépubliez votre service Private Path :

    curl -X POST -sH "Authorization:${iam_token}" \
    "$vpc_api_endpoint/v1/private_path_service_gateways/$ppsgId/unpublish?version=$api_version&generation=2" \
    -d {}'
    

Exemples de commande

  • Publier un service de chemin privé : ibmcloud is ppsgunp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 ibmcloud is private-path-service-gateway-unpublish cli-ppsg-0

Publication d'un service de chemin privé avec Terraform

L'exemple suivant publie un réseau Private Path à l'aide de Terraform :

resource "ibm_is_private_path_service_gateway_operations" "publish" {
  published = true
  private_path_service_gateway = ibm_is_private_path_service_gateway.ppsg.id
}

Pour obtenir de la documentation sur les ressources Terraform, consultez le Registre Terraform.

Dépublier un service de chemin privé avec Terraform

Terraform prendra en charge cette fonctionnalité une fois qu'elle aura atteint la disponibilité générale (GA) et qu'elle sera officiellement publiée.

L'exemple suivant permet de dépublier un réseau Private Path à l'aide de Terraform :

resource "ibm_is_private_path_service_gateway_operations" "publish" {
  published = false
  private_path_service_gateway = ibm_is_private_path_service_gateway.ppsg.id
}

Pour obtenir de la documentation sur les ressources Terraform, consultez le Registre Terraform.

Etapes suivantes

  1. Communiquer les informations de connexion aux consommateurs
  2. Passer en revue les demandes de connexion et Créer des règles de compte