IBM Cloud Docs
Mise à jour et suppression d'un service de chemin privé

Mise à jour et suppression d'un service de chemin privé

Vous pouvez migrer vers une version plus récente du service Chemin privé sans supprimer ni interrompre le service que vous fournissez à vos clients actuels. Vous pouvez supprimer un service Private Path à l'aide de la console, du CLI, de l'API ou de Terraform.

Mise à jour d'un service de chemin privé dans la console

Pour mettre à jour un service de fournisseur de chemin privé 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. Dans la table Services de chemin privé pour VPC, localisez et cliquez sur le nom du service de chemin privé que vous souhaitez mettre à jour.
  4. Sur la page des détails du chemin privé, cliquez sur l'icône Editer icône Editer en regard des détails que vous souhaitez mettre à jour.

Vous pouvez également mettre à jour les membres rattachés à un chemin d'accès privé NLB dans votre service de chemin d'accès privé. Pour plus d'informations, voir Mise à jour d'un équilibreur de charge réseau dans la console.

Mise à jour du service cible d'un service Private Path dans la console

Si vous mettez à jour le service cible réel sans modifier l'équilibreur de charge, vous n'avez pas besoin d'effectuer d'actions dans le service de chemin privé. A la place, vous devez mettre à jour l'équilibreur de charge de réseau de chemin privé. Pour plus d'informations, voir Révision des demandes de connexion.

Pour mettre à jour le service cible d'un service de fournisseur de chemin privé 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 > Équilibreurs de charge.

  3. Sélectionnez la région de votre équilibreur de charge.

  4. Sélectionnez l'équilibreur de charge que vous souhaitez mettre à jour.

  5. Sélectionnez Back-end pools > Create pool pour créer un nouveau pool de serveurs pour votre service mis à jour.

  6. Sélectionnez les nouvelles options de votre pool. Vous disposez des options suivantes :

    • Nom du pool : nom de votre pool. Idéalement, un nom qui décrit la fonction qui est exécutée par ce pool.
    • Protocole : protocole de trafic réseau pour votre trafic.
    • Méthode : algorithme d'équilibrage de charge du pool.
    • Conservation de session : indique si toutes les demandes émises au cours d'une session utilisateur sont envoyées à la même instance.
    • Diagnostic d'intégrité : pour plus d'informations sur la configuration des diagnostics d'intégrité, voir Utilisation des diagnostics d'intégrité.
  7. Veillez à configurer ces serveurs pour votre nouveau service de fournisseur en définissant la méthode sur Permutation circulaire pondérée pour votre ancien pool et votre nouveau pool. Définissez la pondération du nouveau pool sur une valeur différente de zéro et la pondération de l'ancien pool sur une valeur nulle. Le trafic de votre ancien pool de serveurs sera redirigé vers votre nouveau pool de serveurs.

  8. Mettez à jour votre programme d'écoute de front-end existant pour terminer la connexion de votre équilibreur de charge à ce nouveau pool. Sur la page des détails de votre équilibreur de charge, cliquez sur l'onglet Programmes d'écoute de front-end. Dans le tableau, cliquez sur le menu Navigation au bout de la ligne de votre auditeur existant, puis cliquez sur Modifier.

  9. Dans le menu qui apparaît, cliquez sur Éditer. Sous Pool de back-end par défaut, entrez l'ID de votre nouveau pool. Cliquez sur Sauvegarder.

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

Pour supprimer un service de chemin privé dans la console IBM Cloud, procédez comme suit:

  1. Révoquez les comptes associés à des passerelles VPE actives. Pour plus d'informations, voir Mise à jour et suppression d'une stratégie de compte.

    Le consommateur est informé que son compte est refusé et la passerelle VPE passe à l'état " failed

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

  3. Sélectionnez l' icône Menu Navigation, puis cliquez sur Infrastructure > Réseau > Services de chemin privé.

  4. Dans le tableau Services de chemin privé pour VPC, localisez le service de chemin privé que vous souhaitez supprimer, puis cliquez sur Supprimer dans le menu Actions Menu Actions

Mise à jour d'un service de fournisseur depuis l'interface de ligne de commande

L'exemple suivant montre comment mettre à jour un service de fournisseur de chemin privé à partir de l'interface de ligne de commande.

Pour mettre à jour 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-update PRIVATE_PATH_SERVICE_GATEWAY --name NEW_NAME [--default-access-policy deny | permit | review] [--load-balancer LOAD_BALANCER] [--published] [--zonal-affinity false | true] [--output JSON] [-q, --quiet]

Où :

PRIVATE_PATH_SERVICE_GATEWAY
Indique l'ID ou le nom du service de chemin privé.
--default-access-policy
Indique la politique à utiliser pour les liaisons provenant de comptes sans politique de compte explicite. L'un des suivants: deny, permit, review. Valeur par défaut: deny.
--load-balancer
Indique l'ID ou le nom de l'équilibreur de charge pour ce service Private Path.
--published
Indique la disponibilité de ce service de chemin privé. Si elle est transmise, la valeur est définie sur true. Une valeur true signifie que le compte peut demander l'accès à ce service de chemin privé.
--zonal-affinity
Indique si ce service de chemin privé a une affinité zonale. L'un d'entre eux : false, true.
--name
Indique le nouveau nom du service de chemin privé.
--output
Spécifie le format de sortie, seul JSON est pris en charge. Un parmi : JSON.
-q, --quiet
Supprime la sortie prolixe.

Exemples de commande pour la mise à jour d'un service de chemin privé

  • Mettre à jour un service de chemin privé : ibmcloud is private-path-service-gateway-update r006-2e671f14-19fc-4089-9ad3-973176711259 --name cli-ppsg-2 --default-access-policy deny --load-balancer r006-d-740be75d-be41-48bd-b6e4-89946ddcac4a --zonal-affinity false --published

  • Mettre à jour un service de chemin privé : ibmcloud is private-path-service-gateway-update cli-ppsg-2 --name cli-ppsg-0 --default-access-policy review --load-balancer my-cli-nlb-1 --zonal-affinity false --published

Suppression d'un service de chemin privé à partir de l'interface de ligne de commande

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

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

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

  1. Entrez la commande suivante :
ibmcloud is private-path-service-gateway-delete (PRIVATE_PATH_SERVICE_GATEWAY1 PRIVATE_PATH_SERVICE_GATEWAY2 ...)
    [--output JSON] [-f, --force] [-q, --quiet]

Où :

PRIVATE_PATH_SERVICE_GATEWAY1
Indique l'ID ou le nom du service de chemin privé.
PRIVATE_PATH_SERVICE_GATEWAY2
Indique l'ID ou le nom du service de chemin privé.
--output
Spécifie le format de sortie, seul JSON est pris en charge. Un parmi : JSON.
force, -f
Force l'opération sans confirmation.
-q, --quiet
Supprime la sortie prolixe.

Exemples de commande pour la suppression de passerelles de chemin privé

  • Supprimer plusieurs services de chemin privé: ibmcloud is ppsgd r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 r006-72940467-a4db-487f-b57e-b7141ac40e32

  • Supprimer plusieurs services de chemin privé: ibmcloud is private-path-service-gateway-delete cli-ppsg-0 cli-ppsg-1

Mise à jour d'un service de chemin privé à l'aide de l'API

Pour mettre à jour un service de fournisseur 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. Une fois que toutes les variables ont été initiées, effectuez l'une des opérations suivantes :

    • Pour mettre à jour un service de chemin privé:

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

      L'exemple ci-dessus met à jour l'affinité zonale du service de chemin privé vers true.

Suppression d'un service de chemin privé à l'aide de l'API

Pour supprimer un service de chemin privé à l'aide de 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. Une fois que toutes les variables ont été initiées, effectuez l'une des opérations suivantes :

    • Pour supprimer un service de chemin privé:

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

Mise à jour et suppression d'un service Private Path avec Terraform

La mise à jour et la suppression d'un service de chemin privé à l'aide de Terraform s'effectuent avec la même ressource.

L'exemple suivant met à jour et supprime une passerelle de point d'extrémité se liant à un réseau Private Path à l'aide de Terraform :

resource "ibm_is_private_path_service_gateway" "ppsg" {
    default_access_policy = "deny"
    load_balancer = ibm_is_lb.ppnlb.id
    service_endpoints = ["my-service.example.com"]
    zonal_affinity = false
    name = "my-example-ppsg"
}

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