Mise à jour d'un équilibreur de charge d'applications

Vous pouvez mettre à jour un site IBM Cloud® Application Load Balancer for VPC (ALB) à l'aide de la console, du CLI ou de l'API.

Mise à jour d'un équilibreur de charge d'application dans la console

Pour mettre à jour un ALB dans la console d' 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 du menu Navigation, puis cliquez sur l'icône Infrastructure VPC > 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 Pools de back-end si vous devez éditer les paramètres d'un pool ou d'une instance de serveur virtuel.
  6. Sélectionnez Ecouteurs de front-end si vous devez éditer les paramètres d'un écouteur. Pour mettre à jour les valeurs de délai Client/Serveur, sélectionnez Editer dans le menu Actions Icône Actions dans la ligne de l'écouteur que vous souhaitez modifier. Vous pouvez sélectionner une valeur de délai entre 50 secondes et 2 heures (7200 secondes). Cette valeur s'applique à la fois au client et au serveur. Si vous avez besoin de plus de 2 heures, vous pouvez ouvrir un dossier d'assistance et fournir un besoin professionnel pour la valeur de délai requise.
  7. Une fois l'édition terminée, sélectionnez Sauvegarder pour sauvegarder vos modifications.

Le bouton « Actif » situé en haut à gauche de votre fenêtre affiche désormais « Mise à jour en cours ». Lorsque Mise à jour passe à nouveau à Actif, la mise à jour est terminée et les nouvelles modifications sont appliquées.

Mise à jour d'un équilibreur de charge d'application via l'interface de ligne de commande

Il existe plusieurs options pour mettre à jour votre ALB à partir du CLI. Pour les options, voir la référence CLI VPC pour les équilibreurs de charge.

L'exemple suivant illustre l'utilisation de l'interface de ligne de commande pour mettre à jour votre pool d'équilibreur de charge d'application afin qu'il utilise l'algorithme least_connections et le port du membre :

Exemple de commande :

ibmcloud is load-balancer-pool-update r006-99b5ab45-6357-42db-8b32-5d2c8aa62776 r006-3b66d605-6aa5-4166-9f66-b16054da3cb0 --algorithm least_connections

Exemple de sortie :

Updating pool r006-3b66d605-6aa5-4166-9f66-b16054da3cb0 of load balancer r006-99b5ab45-6357-42db-8b32-5d2c8aa62776 under account IBM Cloud Network Services as user test@ibm.com...

ID                         r006-3b66d605-6aa5-4166-9f66-b16054da3cb0
Name                       alb-pool
Protocol                   tcp
Algorithm                  least_connections
Instance group             ID   Name
                           -    -

Health monitor             Type   Port   Health monitor URL   Delay   Retries   Timeout
                           http   8080   /                    10      2         5

Session persistence type   source_ip
Members                    r006-61f8b000-a90d-4abe-909e-c507dffec565
Provision status           update_pending
Created                    2020-08-27T14:45:42.038-05:00

Exemple de commande :

ibmcloud is load-balancer-pool-member-update r006-99b5ab45-6357-42db-8b32-5d2c8aa62776 r006-3b66d605-6aa5-4166-9f66-b16054da3cb0 r006-61f8b000-a90d-4abe-909e-c507dffec565 --port 6060

Exemple de sortie :

Updating member r006-61f8b000-a90d-4abe-909e-c507dffec565 of load balancer pool r006-3b66d605-6aa5-4166-9f66-b16054da3cb0 under account IBM Cloud Network Services as user test@ibm.com...

ID                 r006-61f8b000-a90d-4abe-909e-c507dffec565
Port               6060
Target             0716_6acdd058-4607-4463-af08-d4999d983945
Weight             70
Health             unknown
Created            2020-08-27T14:59:55.446-05:00
Provision status   update_pending

Mise à jour de la valeur du délai d'attente d'un équilibreur de charge d'application à partir de la CLI

L'exemple suivant montre comment utiliser la CLI pour mettre à jour la valeur du délai d'attente de l'ALB :

  1. Obtenir l'identifiant de l'auditeur :
ibmcloud is load-balancer LOAD_BALANCER_ID
  1. Vérifier les détails de l'auditeur actuel :
ibmcloud is load-balancer-listener [--load-balancer LOAD_BALANCER_ID] [--listener LISTENER_ID] [--output JSON]
  1. Mettre à jour la valeur du délai d'attente :
ibmcloud is load-balancer-listener-update [--load-balancer LOAD_BALANCER_ID] [--listener LISTENER_ID] [--idle-connection-timeout VALUE_IN_SECONDS]

Où :

--load-balancer
ID ou nom de l'équilibreur de charge.
--listener
ID ou nom de l'auditeur.
--output
Format de sortie : seul le format « JSON » est pris en charge.
--idle-connection-timeout
Valeur du délai d'inactivité de la connexion en secondes.

Exemple de commande :

ibmcloud is load-balancer-listener-update r042-ce351658-c236-4c99-8711-1414c5a6a99c r042-a00f2544-a1d3-4f9b-af31-4c34990a01f0 --idle-connection-timeout 90

Exemple de sortie :

Updating listener r042-a00f2544-a1d3-4f9b-af31-4c34990a01f0 of load balancer r042-ce351658-c236-4c99-8711-1414c5a6a99c under account SoftLayer Internal - Network Operations as user labhatia@in.ibm.com...

ID                        r042-a00f2544-a1d3-4f9b-af31-4c34990a01f0
Certificate instance      -
Connection limit          -
Ports                     22
Idle connection timeout   90
Protocol                  http
Default pool              -
Accept proxy protocol     false
Provision status          update_pending
Created                   2025-04-15T14:11:06+05:30

Mise à jour d'un équilibreur de charge d'application via l'API

L'exemple suivant explique comment utiliser l'API pour mettre à jour le port d'écoute de front-end d'un équilibreur de charge d'application. Par exemple, si le port de l'écouteur de front-end était défini sur 80 et que vous souhaitez spécifiez 90.

Pour mettre à jour un équilibreur de charge d'application via l'API, procédez comme suit :

  1. Configurez votre environnement d'API.

  2. Utilisez l'exemple suivant pour obtenir l'ID écouteur dont vous avez besoin pour la mise à jour :

    Sauvegardez l'ID de l'équilibreur de charge :

    export lbid="r042-ce351658-c236-4c99-8711-1414c5a6a99c"

    Installez "jq" pour afficher la sortie de la commande suivante dans un format JSON propre.

    curl -H "Authorization: Bearer $iam_token" -X GET
"$vpc_api_endpoint/v1/load_balancers/$lbid?version=$api_version&generation=2" | jq

    Exemple de sortie :

    {
 "access_mode": "private",
 "attached_load_balancer_pool_members": [],
 "availability": "subnet",
 "created_at": "2024-12-23T06:29:04Z",
 "crn": "crn:v1:bluemix:public:is:br-sao:a/5a83dca0e9c3408788bac5da136a9e76::load-balancer:r042-ce351658-c236-4c99-8711-1414c5a6a99c",
 "dns": {
     "instance": {
     "crn": "crn:v1:bluemix:public:dns-svcs:global:a/74589ab5050034ede18fa510153e91f8:a2b96ed8-cea2-4db0-b60a-c02d99586d4f::"
     },
     "zone": {
     "id": "a9240f0c-da77-4c55-be84-1d56c549a4de"
     }
 },
 "failsafe_policy_actions": [
     "fail",
     "drop",
     "forward"
 ],
 "hostname": "ce351658-br-sao.test.com",
 "href": "https://br-sao.iaas.cloud.ibm.com/v1/load_balancers/r042-ce351658-c236-4c99-8711-1414c5a6a99c",
 "id": "r042-ce351658-c236-4c99-8711-1414c5a6a99c",
 "instance_groups_supported": true,
 "is_private_path": false,
 "is_public": false,
 "listeners": [
     {
     "href": "https://br-sao.iaas.cloud.ibm.com/v1/load_balancers/r042-ce351658-c236-4c99-8711-1414c5a6a99c/listeners/r042-a00f2544-a1d3-4f9b-af31-4c34990a01f0",
     "id": "r042-a00f2544-a1d3-4f9b-af31-4c34990a01f0"
     }
 ],
 "logging": {
     "datapath": {
     "active": true
     }
 },
 "name": "test-alb",
 "operating_status": "online",
 "pools": [
     {
     "href": "https://br-sao.iaas.cloud.ibm.com/v1/load_balancers/r042-ce351658-c236-4c99-8711-1414c5a6a99c/pools/r042-40fe93a2-16f4-467d-b0e4-70c7b093e137",
     "id": "r042-40fe93a2-16f4-467d-b0e4-70c7b093e137",
     "name": "pooltest"
     }
 ],
 "private_ips": [
     {
     "address": "192.168.40.12",
     "href": "https://br-sao.iaas.cloud.ibm.com/v1/subnets/02v7-3520cb95-db1a-4787-9bde-f9cb8e811685/reserved_ips/02v7-be9dd47d-3899-4f67-8f7d-0a38ee73a376",
     "id": "02v7-be9dd47d-3899-4f67-8f7d-0a38ee73a376",
     "name": "author-sabbatical-zookeeper-paddleboat",
     "resource_type": "subnet_reserved_ip"
     },
     {
     "address": "192.168.40.13",
     "href": "https://br-sao.iaas.cloud.ibm.com/v1/subnets/02v7-3520cb95-db1a-4787-9bde-f9cb8e811685/reserved_ips/02v7-4a439c6a-15ed-43c0-910c-345d3af5f0c0",
     "id": "02v7-4a439c6a-15ed-43c0-910c-345d3af5f0c0",
     "name": "thinning-visitor-prance-chaps",
     "resource_type": "subnet_reserved_ip"
     }
 ],
 "profile": {
     "family": "application",
     "href": "https://br-sao.iaas.cloud.ibm.com/v1/load_balancer/profiles/dynamic",
     "name": "dynamic"
 },
 "provisioning_status": "active",
 "public_ips": [],
 "resource_group": {
     "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/5710acc3545d425db62cb37037d17245",
     "id": "5710acc3545d425db62cb37037d17245",
     "name": "Default"
 },
 "resource_type": "load_balancer",
 "route_mode": false,
 "security_groups": [
     {
     "crn": "crn:v1:bluemix:public:is:br-sao:a/5a83dca0e9c3408788bac5da136a9e76::security-group:r042-f9a9b05b-9f19-4e65-a39c-8e5ccd1b0303",
     "href": "https://br-sao.iaas.cloud.ibm.com/v1/security_groups/r042-f9a9b05b-9f19-4e65-a39c-8e5ccd1b0303",
     "id": "r042-f9a9b05b-9f19-4e65-a39c-8e5ccd1b0303",
     "name": "resent-wrongness-erasure-flaky"
     }
 ],
 "security_groups_supported": true,
 "source_ip_session_persistence_supported": true,
 "subnets": [
     {
     "crn": "crn:v1:bluemix:public:is:br-sao-3:a/5a83dca0e9c3408788bac5da136a9e76::subnet:02v7-3520cb95-db1a-4787-9bde-f9cb8e811685",
     "href": "https://br-sao.iaas.cloud.ibm.com/v1/subnets/02v7-3520cb95-db1a-4787-9bde-f9cb8e811685",
     "id": "02v7-3520cb95-db1a-4787-9bde-f9cb8e811685",
     "name": "subnet-test-zone3",
     "resource_type": "subnet"
     }
 ],
 "udp_supported": false
}
    1. Sauvegardez l'ID écouteur à mettre à jour à partir de l'étape précédente. Sauvegardez-le, par exemple, dans la variable listenerid.
    export listenerid="r042-a00f2544-a1d3-4f9b-af31-4c34990a01f0"
    1. Mettez à jour les valeurs du port d'écoute et du délai d'attente client/serveur de l'équilibreur de charge :
    curl -H "Authorization: Bearer $iam_token" -X PATCH
"$vpc_api_endpoint/v1/load_balancers/$lbid/listeners/$listenerid?version=$api_version&generation=2" \
    -d '{"idle_connection_timeout": 50 , "port": 8080}' | jq

    Exemple de sortie :

    {
    "id": "r042-a00f2544-a1d3-4f9b-af31-4c34990a01f0",
    "href": "https://br-sao.iaas.cloud.ibm.com/v1/load_balancers/r042-ce351658-c236-4c99-8711-1414c5a6a99c/listeners/r042-a00f2544-a1d3-4f9b-af31-4c34990a01f0",
    "protocol": "http",
    "port": 8080,
    "port_min": 8080,
    "port_max": 8080,
    "provisioning_status": "update_pending",
    "created_at": "2025-04-15T08:41:06Z",
    "accept_proxy_protocol": false,
    "idle_connection_timeout": 50
}

Vous pouvez définir un délai d'attente compris entre 50 et 7200 secondes. Si vous avez besoin de plus de 2 heures (7200 secondes), vous pouvez ouvrir un dossier d'assistance.