Documentación de Oracle Cloud Infrastructure

Creación de un pool de instancia

En Compute Cloud@Customer, puede crear un pool de instancias dentro de la misma región.

Al realizar operaciones como restablecer o suprimir el objeto de pool, se realiza esa operación en todas las instancias que son miembros del pool. La realización de estas operaciones en una instancia individual que sea miembro del pool no afecta a ninguna otra instancia miembro.

Para crear un pool de instancias se necesita una configuración de instancia y una configuración de ubicación. Las instancias que se agregan al pool en una actualización de pool se pueden crear con diferentes configuraciones de instancia y ubicación.

Para las instancias de un pool, se ignora el valor de la propiedad displayName en la configuración de instancia. Las instancias de un pool se denominan inst-aaaaa-pool_name, donde aaaaa tiene cinco caracteres alfanuméricos aleatorios.

Configuración de colocación

Además de una configuración de instancia, la creación de pools requiere una configuración de ubicación. Los valores especificados en una configuración de ubicación sustituyen los valores especificados en la configuración de instancia.

Una configuración de ubicación puede especificar dominios de errores, subred principal y subredes de VNIC secundarias.

Dominios de errores

Si no especifica un dominio de errores en la configuración de instancia o en la configuración de ubicación, el sistema selecciona automáticamente los mejores dominios de errores para las instancias de pool. Si especifica un solo dominio de errores, todas las instancias se colocarán solo en ese dominio de errores. Si especifica más de un dominio de errores, las instancias del pool se colocan en esos dominios de errores de forma uniforme, lo que proporciona una mejor alta disponibilidad para el pool. Si un dominio de errores no puede incluir instancias adicionales, la creación de instancias se para. El sistema no colocará más instancias en un dominio de errores que en otro dominio de errores.

Si algunas instancias no se pueden iniciar debido a restricciones de recursos, esas instancias permanecen en el estado Aprovisionando y el pool permanece en el estado Escalando. Después de iniciar las instancias size, el pool puede pasar al estado Running. Mientras el pool está en estado Escala, las instancias del pool que están en estado En ejecución están disponibles para su uso.

A continuación se muestran ejemplos de acciones que puede realizar si una instancia de pool no se inicia debido a restricciones de recursos:

  • Actualice el pool y reduzca el valor de "Número de instancias" o size.

  • Actualice el pool y cambie la especificación del dominio de errores en la consola de Compute Cloud@Customer o en una nueva instancia o configuración de ubicación.

  • Actualice el pool para especificar una nueva configuración de instancia que cree instancias que necesiten menos recursos.

  • Pare una instancia que no sea miembro de un pool en el mismo dominio de errores en el que la instancia del pool no se está iniciando debido a restricciones de recursos.

  • Suprima una instancia que no sea miembro de un pool en el mismo dominio de errores en el que la instancia del pool no se puede iniciar debido a restricciones de recursos.

Requisito

Antes de crear un pool de instancias, necesita una configuración de instancia. Una configuración de instancia es una plantilla que define los valores que se utilizarán al crear instancias. Consulte Trabajar con configuraciones de instancias.

Evite introducir información confidencial en nombres y etiquetas.

    1. En el menú de navegación de la consola de Compute Cloud@Customer, seleccione Recursos informáticos y, a continuación, seleccione Configuraciones de instancia.

    2. En la parte superior de la página, seleccione el compartimento que contiene la configuración de instancia que desea utilizar para crear el pool.

    3. Seleccione la configuración de instancia que desea utilizar para las instancias de este pool.

    4. En Recursos, seleccione Pools de instancias asociadas.
    5. En la parte superior de la página, seleccione otros compartimentos para mostrar los pools de otros compartimentos.

      Seleccione Crear pool de instancias.

    6. En el cuadro de diálogo Asociar pool de instancias a instance_configuration_name, introduzca la siguiente información:

      • Nombre: introduzca un nombre para el pool de instancias. El nombre no tiene que ser único. Este nombre se utiliza en los nombres de las instancias creadas. Si no proporciona un nombre para el pool, el nombre por defecto del pool de instancias es instancepoolYYYYMMDDhhmmss, donde YYYYMMDDhhmmss es la fecha y hora de creación.

      • Crear en compartimento: seleccione un compartimento para esta definición de pool de instancias. Tenga en cuenta que las instancias del pool se crearán en el compartimento especificado en la configuración de instancia.

      • Número de instancias: especifique el número de instancias que se van a crear en este pool de instancias.

      • Colocación de pool: seleccione los dominios de errores, la VCN y la subred para las instancias de este pool de instancias. Puede seleccionar un compartimento diferente del que seleccionar la VCN y la subred. Consulte las descripciones de la configuración de ubicación y los dominios de errores al principio de esta sección.

      • Equilibradores de carga: seleccione la casilla Asociar equilibradores de carga para especificar el equilibrio de carga para este pool. Para obtener información sobre el equilibrio de carga, consulte Equilibrador de carga como servicio. Proporcione la siguiente información:

        • Seleccione el equilibrador de carga que desea asociar a este pool.

        • Seleccione el juego de backends al que desea agregar estas instancias de pool.

        • Introduzca el número de puerto de las instancias al que el equilibrador de carga debe dirigir el tráfico.

        • Seleccione la VNIC que se utilizará al agregar la instancia al juego de backends. Se utiliza la dirección IP privada.

        Para asociar otro equilibrador de carga, seleccione Agregar equilibrador de carga. Para asociar un equilibrador de carga después de crear el pool de instancias, consulte Gestión de asociaciones de equilibrador de carga de pool de instancias.

      • Etiquetado: (opcional) agregue una o más etiquetas a este recurso. Las etiquetas también se pueden aplicar más adelante. Para obtener más información sobre el etiquetado de recursos, consulte Etiquetas de recursos.

    7. Seleccione Crear pool de instancias.

      Se muestra la página de detalles del nuevo pool. Las instancias solicitadas se muestran en la tabla Instancias asociadas de la sección Recursos a medida que se crean. Las nuevas instancias se denominan inst-aaaaa-pool_name, donde aaaaa tiene cinco caracteres alfanuméricos aleatorios. Si cambia el nombre del pool y, a continuación, agrega nuevas instancias al pool, las nuevas instancias tendrán el nuevo nombre.

      Seleccione Solicitudes de trabajo en la casilla Recursos para comprobar el estado de la creación del pool de instancias.

  • Utilice el comando oci compute-management instance-pool create y los parámetros necesarios para crear un pool de instancias.

    oci compute-management instance-pool create --compartment-id <compartment_OCID> --instance-configuration-id <instance-configuration_OCID> --placement-configurations <placement_configurations.json> [OPTIONS]

    Para obtener una lista completa de los comandos, los indicadores y las opciones de la CLI, consulte la Referencia de la línea de comandos.

    Procedimiento

    1. Obtenga la siguiente información:

      • OCID del compartimento en el que desea crear la definición del pool de instancias: oci iam compartment list

        Tenga en cuenta que las instancias del pool se crean en el compartimento especificado en la configuración de instancia.

      • OCID de la configuración de instancia que desea utilizar: oci compute-management instance-configuration list

      • Tamaño del pool de instancias. Este es el número de instancias informáticas del pool de instancias.

      • Si desea equilibrar la carga de este pool, obtenga la siguiente información:

        • OCID del equilibrador de carga que se va a asociar a este pool y nombre del juego de backends al que se van a agregar estas instancias de pool: oci lb load-balancer list

        • Valor de puerto que se utilizará al crear el juego de backends.

        • VNIC para asociar al equilibrador de carga. El valor puede ser PrimaryVnic o el nombre mostrado de una de las VNIC secundarias en la configuración de instancia asociada al pool de instancias.

    2. Cree un argumento para la opción --placement-configurations.

      Consulte las descripciones de la configuración de colocación y los dominios de errores al principio de esta sección.

      Utilice el siguiente comando para mostrar el contenido del argumento de configuraciones de colocación:

      $ oci compute-management instance-pool create --generate-param-json-input placement-configurations

    3. Si desea equilibrar la carga para este pool, cree un argumento para la opción --load-balancers.

      Utilice el siguiente comando para mostrar el contenido del argumento de los equilibradores de carga:

      $ oci compute-management instance-pool create --generate-param-json-input load-balancers

      Para asociar un equilibrador de carga después de crear el pool de instancias, consulte Gestión de asociaciones del equilibrador de carga del pool de instancias.

    4. Ejecute el comando de creación del pool de instancias.

      Sintaxis:

      oci compute-management instance-pool create -c compartment_OCID --instance-configuration-id instance_configuration_OCID --placement-configurations file://placement_configuration.json --size number_of_instances

      Ejemplo:

      $ oci compute-management instance-pool create --compartment-id ocid1.compartment.unique_ID --display-name support-pool --instance-configuration-id ocid1.instanceConfiguration.unique_ID --placement-configurations file://./placement_configurations.json --load-balancers file://./load_balancers.json --size 10

      El valor de la opción --display-name es el nombre de la agrupación. No es necesario que el nombre del grupo sea único. Si no proporciona un valor para la opción --display-name, el nombre por defecto del pool de instancias es instancepoolYYYYMMDDhhmmss, donde YYYYMMDDhhmmss es la fecha y hora de creación.

      El nombre del pool se utiliza en los nombres de las instancias. Las instancias de un pool se denominan inst-aaaaa-pool_name, donde aaaaa tiene cinco caracteres alfanuméricos aleatorios. Si cambia el nombre del pool y, a continuación, agrega nuevas instancias al pool, las nuevas instancias tendrán el nuevo nombre.

      La salida de este comando es la misma que la salida del comando instance-pool get. No se muestra la lista de instancias del pool.

      Para mostrar las instancias que pertenecen a este pool, utilice el siguiente comando:

      $ oci compute-management instance-pool list-instances -c <compartment_OCID> --instance-pool-id <instance_pool_OCID>

      La salida de cada instancia se abrevia en comparación con la salida del comando instance get.

      El siguiente comando muestra la misma salida abreviada solo para la instancia especificada:

      $ oci compute-management instance-pool-instance get --instance-id ocid1.instance.unique_ID \
--instance-pool-id ocid1.instancePool.unique_ID

  • Utilice la operación CreateInstancePool para crear un pool de instancias.

    Para obtener más información sobre el uso de la API y la firma de solicitudes, consulte API de REST y Credenciales de seguridad. Para obtener información sobre los SDK, consulte Software development kits e interfaz de línea de comandos.