Actualización de un equilibrador de carga de aplicación

Puede actualizar un IBM Cloud® Application Load Balancer for VPC (ALB) con la consola, CLI o API.

Actualización de un balanceador de carga de aplicaciones en la consola

Para actualizar un ALB en la consola de IBM Cloud, siga estos pasos:

  1. Desde tu navegador, abre la consola de IBM Cloud e inicia sesión en tu cuenta.
  2. Seleccione el ícono Menú del menú de Navegación, luego haga clic en el ícono Infraestructura VPC > Red > Balanceadores de carga.
  3. Seleccione la región del equilibrador de carga.
  4. Seleccione el equilibrador de carga que desea actualizar.
  5. Seleccione Agrupaciones de fondo si necesita editar los parámetros de una instancia de servidor virtual o de una agrupación.
  6. Seleccione Escuchas frontales si necesita editar parámetros de escucha. Para actualizar los valores de tiempo de espera Cliente/Servidor, seleccione Editar en el menú Acciones Icono Acciones en la fila del Listener que desea editar. Puede seleccionar un valor de tiempo de espera entre 50 segundos y 2 horas (7200 segundos). Este valor es tanto para el cliente como para el servidor. Si necesita más de 2 horas, puede abrir un caso de soporte y proporcionar un requisito de negocio para el valor de tiempo de espera requerido.
  7. Después de realizar la edición, seleccione Guardar para guardar los cambios.

El botón «Activo», situado en la parte superior izquierda de la ventana, ahora aparece como « Actualizando ». Cuando En actualización vuelve a Activo, la actualización se habrá terminado y se aplican los cambios nuevos.

Actualización de un equilibrador de carga de aplicaciones desde la interfaz de línea de comandos

Existen múltiples opciones para actualizar tu ALB desde la CLI. Para conocer las opciones, consulte VPC CLI reference for load balancers.

En el ejemplo siguiente se muestra cómo utilizar la CLI para actualizar la agrupación de ALB para utilizar el algoritmo least_connections y el puerto del miembro:

Mandato de ejemplo:

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

Salida de ejemplo:

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

Mandato de ejemplo:

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

Salida de ejemplo:

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

Actualización de un valor de tiempo de espera del balanceador de carga de aplicaciones desde la CLI

El siguiente ejemplo muestra cómo utilizar la CLI para actualizar el valor del tiempo de espera del ALB:

  1. Obtener el ID del oyente:
ibmcloud is load-balancer LOAD_BALANCER_ID
  1. Verifique los detalles del oyente actual:
ibmcloud is load-balancer-listener [--load-balancer LOAD_BALANCER_ID] [--listener LISTENER_ID] [--output JSON]
  1. Actualiza el valor del tiempo de espera:
ibmcloud is load-balancer-listener-update [--load-balancer LOAD_BALANCER_ID] [--listener LISTENER_ID] [--idle-connection-timeout VALUE_IN_SECONDS]

Donde:

--load-balancer
Nombre del equilibrador de carga.
--listener
ID o nombre del oyente.
--output
Formato de salida: solo se admite el formato « JSON ».
--idle-connection-timeout
Valor del tiempo de espera de la conexión inactiva en segundos.

Mandato de ejemplo:

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

Salida de ejemplo:

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

Actualización de un equilibrador de carga de aplicaciones mediante la API

En el ejemplo siguiente se muestra cómo utilizar la API para actualizar el puerto de escucha frontal de un equilibrador de carga de aplicaciones. Por ejemplo, si el puerto de escucha frontal se ha establecido en 80 y desea actualizar el valor de puerto a 90.

Para actualizar un equilibrador de carga de aplicaciones mediante la API, sigue estos pasos:

  1. Configure el entorno de la API.

  2. Utilice el ejemplo siguiente para obtener el ID de escucha que necesita para la actualización:

    Guarde el ID del equilibrador de carga:

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

    Instale "jq" para ver la salida del siguiente comando en formato JSON limpio.

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

    Salida de ejemplo:

    {
 "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. Guarde el ID de escucha que desea actualizar del paso anterior. Por ejemplo, guárdelo en la variable listenerid.
    export listenerid="r042-a00f2544-a1d3-4f9b-af31-4c34990a01f0"
    1. Actualice los valores del puerto de escucha y del tiempo de espera cliente/servidor del equilibrador de carga:
    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

    Salida de ejemplo:

    {
    "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
}

Puedes establecer un valor de tiempo de espera entre 50 y 7200 segundos. Si necesitas más de 2 horas (7200 segundos), puedes abrir un caso de soporte.