Documentación de Oracle Cloud Infrastructure

Creación de una configuración de instancia mediante la introducción de valores de configuración

En Compute Cloud@Customer, puede crear una configuración de instancia introduciendo valores para valores de configuración de instancia individuales.

Nota

Si especifica un tamaño de volumen de inicio mayor que el predeterminado, deberá ampliar el volumen para aprovechar el tamaño más grande. Consulte Cambio de tamaño de volúmenes.

Evite introducir información confidencial en nombres y etiquetas.

Información importante sobre el uso de imágenes de Marketplace para crear instancias

La primera vez que cree una instancia mediante una imagen de Marketplace, debe utilizar la consola de Compute Cloud@Customer para poder aceptar el acuerdo de usuario. Después de eso, puede utilizar la consola, la CLI y la API para crear instancias con una imagen de Marketplace.

Para mantener la integridad de las imágenes de Marketplace, existen restricciones y acciones permitidas. Para obtener más información, consulte Restricciones de imágenes de Marketplace y Administración de imágenes de Marketplace permitida.

    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. Seleccione Crear configuración de instancias.

    3. En el cuadro de diálogo Crear configuración de instancia, introduzca la siguiente información:

      • Nombre: introduzca un nombre para la configuración de la instancia.

      • Crear en compartimento: seleccione el compartimento en el que desea crear esta configuración de instancia.

      • Compartimento en el que crear instancias: seleccione el compartimento en el que desea crear las instancias.

      • Dominio de errores: (opcional) puede seleccionar un dominio de errores. Por defecto, el sistema selecciona automáticamente el mejor dominio de errores para las instancias. Si especifica un dominio de errores y el dominio de errores solicitado no puede alojar la instancia, se producirá un fallo al iniciar la instancia. Consulte más información sobre los dominios de errores en Creación de una instancia.

      • Imagen de origen: seleccione una imagen o un volumen de inicio.

        1. Seleccione el tipo de origen:

          • Imagen de plataforma: seleccione esta opción para crear una instancia basada en una de las imágenes de Oracle Linux y Oracle Solaris que están disponibles en cada compartimento. Consulte Imágenes de plataforma de Compute Cloud@Customer.
          • Imagen personalizada: se puede seleccionar si se ha creado una imagen personalizada. Puede que necesite seleccionar el compartimento donde se encuentra la imagen personalizada. Consulte Gestión de imágenes personalizadas.
          • Volumen de inicio: seleccione esta opción para crear la instancia basada en un volumen de inicio existente. Puede que necesite seleccionar el compartimento donde se encuentra el volumen de inicio.
          • Imagen de Marketplace: se puede seleccionar si hay imágenes de Marketplace disponibles en Compute Cloud@Customer. Consulte Imágenes de Marketplace.

        2. Seleccione una imagen o un volumen de inicio de la lista.

          Si ha seleccionado Imagen de plataforma, verá una lista tabular con las columnas Sistema operativo, Versión de sistema operativo y Creación de imagen (la fecha en la que se creó la imagen). Puede utilizar la flecha del menú desplegable a la derecha de la versión del sistema operativo para seleccionar una versión diferente. Por ejemplo, para el sistema operativo Oracle Linux, puede utilizar el menú desplegable para seleccionar 9, 8 o 7.9.

          Si ha seleccionado Imagen personalizada, verá una lista tabular con las columnas Nombre, Sistema operativo y Versión de sistema operativo. Puede utilizar las flechas de las cabeceras de columna para ordenar la lista. Puede filtrar la lista mediante el menú desplegable Operating System (Sistema operativo) situado encima de la lista de imágenes.

          Si ha seleccionado Volumen de inicio, verá una lista tabular con las columnas Nombre, Tamaño (GB) y Creado (la fecha en la que se creó el volumen de inicio). Puede utilizar las flechas de las cabeceras de columna para ordenar la lista. En la sección Volumen de inicio (después de la sección Unidad), puede personalizar el tamaño del volumen de inicio.

          Si la lista es demasiado larga para caber en una vista, utilice los botones de flecha para ver otra página de la lista.

          Para utilizar una imagen de plataforma que estaba disponible anteriormente pero que ya no aparece en la lista, utilice la consola para crear la instancia y especificar el OCID de la imagen.

          Si ha seleccionado una imagen de Marketplace, seleccione una imagen de Marketplace. Si es la primera vez que ha creado una instancia con esta imagen de Marketplace, se muestra un panel de acuerdo. Antes de crear la instancia, debe seleccionar Aceptar acuerdo y confirmar el acuerdo.

      • Unidad: si está utilizando una imagen de plataforma, seleccione VM.PCAStandard.E5. Unidad flexible y configure el número de OCPU y memoria.

        Para los valores de OCPU y memoria, seleccione dentro de cada campo de valor para ver los valores mínimo y máximo permitidos. La configuración de OCPU y memoria se puede cambiar después de crear la instancia.

        Para obtener una descripción de la unidad soportada, consulte Unidades de computación.

      • Volumen de inicio: (opcional) marque la casilla para especificar un tamaño de volumen de inicio o una configuración de rendimiento de volumen.

        • Tamaño de volumen de inicio (GB): se muestra el tamaño de volumen de inicio por defecto para la imagen seleccionada. Para especificar un tamaño mayor, introduzca un número entero de gigabytes de hasta 16384 (16 TB) o utilice las flechas de incremento y disminución. No puede introducir un valor menor que el tamaño por defecto.

          Si especifica un tamaño de volumen de inicio personalizado, deberá ampliar la partición para aprovechar el tamaño más grande. Las imágenes de la plataforma Oracle Linux incluyen el paquete oci-utils. Utilice el comando oci-growfs de ese paquete para ampliar la partición raíz y, a continuación, aumentar el sistema de archivos. Para otros sistemas operativos o imágenes personalizadas, siga las instrucciones de ese sistema operativo.

        • Rendimiento de volumen de inicio (VPU): utilice las flechas de incremento y disminución para alternar entre el rendimiento equilibrado (10 VPU/GB) y el alto rendimiento (20 VPU/GB).

      • Subnet: seleccione una subred.

        1. Seleccione una VCN en la lista. Puede que tenga que cambiar el compartimento al compartimento donde se encuentra la VCN.

        2. Seleccionar una subred.

      • Dirección IP pública: para utilizar SSH para conectarse a instancias creadas con esta configuración de instancia, active la casilla Asignar IP pública para tener una dirección IP pública asignada a las instancias. Esta casilla se activa por defecto si ha especificado una subred pública. Si no marca esta casilla o si la desactiva y, a continuación, desea asignar una dirección IP pública más tarde, consulte Asignación de una dirección IP pública efímera a una instancia para obtener instrucciones.

      • VNIC secundarias: (opcional) active la casilla Crear VNIC adicional para crear VNIC secundarias para las instancias creadas con esta configuración de instancia. Para obtener descripciones de la información solicitada, consulte Creación y asociación de una VNIC secundaria.

      • Dirección IP privada: (opcional) especifique una dirección IP privada disponible desde el CIDR de la subred. Por defecto, se asigna automáticamente una dirección IP privada.

        Nota

        Puesto que la dirección IP privada debe ser única para cada instancia, no especifique una dirección IP privada si va a utilizar esta configuración de instancia para crear un pool de instancias.

      • Registro de DNS: (opcional) marque la casilla Asignar un registro de DNS privado para asignar un registro de DNS a las instancias creadas con esta configuración de instancia.

      • Nombre de host: (opcional) introduzca un nombre de host si utiliza DNS en la red en la nube. El nombre de host debe ser único en todas las VNIC de la subred.

        Nota

        No especifique un nombre de host si va a utilizar esta configuración de instancia para crear un pool de instancias.

        Por defecto, el nombre de instancia se utiliza para el nombre de host. El nombre de host también se puede configurar en el sistema operativo después de crear la instancia.

        Si se trata de una instancia de UNIX, consulte Creating a Mount Target y Mounting File Systems on UNIX-based Instances para obtener más información sobre la configuración correcta del nombre de host para el montaje de sistemas de archivos.

      • Claves SSH: para conectarse a la instancia mediante SSH, proporcione una clave SSH pública.

        Nota

        No puede proporcionar esta clave SSH después de crear la instancia.

      • Grupo de seguridad de red: (opcional) por defecto, las instancias no están asociadas a ningún NSG. Marque la casilla Activar grupo de seguridad de red para agregar la VNIC principal de esta instancia a uno o más NSG.

        1. Seleccione un NSG de la lista desplegable. Puede que necesite cambiar el compartimento para buscar el NSG que desee.

        2. Seleccione Agregar grupo de seguridad de red para asociarlo a otro NSG.

        3. Para eliminar un NSG de la lista, seleccione la papelera a la derecha de ese NSG. Para eliminar el último NSG o todos los NSG, desactive la casilla Activar grupos de seguridad de red.

        Consulte Controlling Traffic with Network Security Groups para obtener información sobre los NSG.

      • Opciones de instancia: active la casilla para desactivar los puntos finales del servicio de metadatos de instancia heredada. Por defecto, las rutas del servicio de metadatos de instancia (IMDS) heredado (/v1) están activadas. Si ha actualizado las aplicaciones para que utilicen puntos finales /v2, active esta casilla para desactivar los puntos finales /v1. Para obtener más información sobre el servicio de metadatos de instancia, consulte Recuperación de metadatos de instancia desde dentro de la instancia. Para obtener más información sobre la actualización de las aplicaciones, consulte Actualización a puntos finales de IMDS versión 2.

      • Configuración de disponibilidad: (opcional) por defecto, el sistema selecciona automáticamente la mejor opción de disponibilidad de instancia durante una operación de mantenimiento, como la migración en directo. Marque la casilla Restaurar estado de ciclo de vida de instancia después del mantenimiento de la infraestructura para especificar que las instancias en ejecución se deben reiniciar automáticamente después de un evento de mantenimiento. Si esta casilla no está marcada, la instancia se recupera en estado detenido.

      • 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.

    4. Seleccione Crear configuración de instancias.

  • Utilice el comando oci compute-management instance-configuration create y los parámetros necesarios para crear una configuración de instancia introduciendo valores de configuración.

    oci compute-management instance-configuration create -c <compartment_OCID> --display-name <IC_name> --instance-details file://<custom_config_file>.json

    El compartimento especificado es donde se crea esta configuración de instancia. Este compartimento puede ser diferente del compartimento especificado en el archivo JSON de detalles de la instancia, que es donde se crearán las instancias.

    El nombre mostrado especificado es el nombre de la configuración de la instancia. Si no proporciona un valor para la opción --display-name, el nombre por defecto de la configuración de instancia es instanceconfiguration YYYYMMDDhhmmss , donde YYYYMMDDhhmmss es la fecha y hora de creación.

    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:

      • El OCID del compartimento en el que desea crear esta configuración de instancia.

      • OCID del compartimento en el que desea crear las instancias que utilizan esta configuración de instancia.

      • Nombre del dominio de disponibilidad para las instancias que utilizan esta configuración de instancia.

      • OCID de la imagen o el volumen de inicio para las instancias que utilizan esta configuración de instancia.

      • Nombre de la unidad para las instancias que utilizan esta configuración de instancia.

      • OCID de la subred para las instancias que utilizan esta configuración de instancia.

    2. Cree el archivo de configuración que proporciona la entrada para el comando configuration create.

      El archivo de configuración es un archivo JSON de pares de propiedad/valor.

      • Utilice el siguiente comando para generar la sintaxis correcta del archivo de configuración y los nombres de las propiedades:

        $ oci compute-management instance-configuration create --generate-param-json-input instance-details > instance_details.json

        No necesita todos los datos que se muestran con este comando. Copie solo la información que necesita, teniendo cuidado de mantener cada propiedad en su contexto correcto.

        Si omite la especificación del dominio de errores, el sistema selecciona automáticamente el mejor dominio de errores. Si especifica un solo dominio de errores, todas las instancias se colocan solo en ese dominio de errores.

        Si un dominio de errores que especifique no tiene suficientes recursos, es posible que las instancias no se inicien:

        • Al crear una única instancia (Uso de una configuración de instancia para crear una instancia) y especificar un dominio de errores en la configuración de la instancia, solo se utiliza el dominio de errores especificado para crear la instancia. Las restricciones de recursos pueden provocar que falle el inicio de la instancia.

        • Al crear instancias en un pool, los dominios de errores especificados en la configuración de ubicación sustituyen a los dominios de errores especificados en la configuración de la instancia. Consulte Creación de un pool de instancias para obtener más información.

        Puede especificar VNIC y subredes secundarias. Si especifica una etiqueta de nombre de host para una VNIC secundaria, la etiqueta de nombre de host especificada debe ser única en todas las VNIC de la subred. Si proporciona un valor para la propiedad hostnameLabel, también debe definir el valor de assignPrivateDnsRecord en true.

        • Si la etiqueta de nombre de host especificada ya está en uso en la subred, el inicio de la instancia (Uso de una configuración de instancia para crear una instancia) fallará con el error "Nombre de host hostname ya en uso para la subred".

        • La propiedad hostnameLabel se ignora al utilizar la configuración de instancia para crear un pool de instancias. Por defecto, el nombre de instancia se utiliza para el nombre de host.

        Si omite la propiedad assignPublicIp, se asigna una dirección IP pública por defecto si especifica una subred pública. Si define esta propiedad en false y, a continuación, decide asignar una dirección IP pública más adelante, consulte Assigning an Ephemeral Public IP Address to an Instance para obtener instrucciones.

        Si los usuarios van a utilizar ssh para conectarse a la instancia, especifique la clave pública SSH como valor de la propiedad ssh_authorized_keys en el bloque metadata. No puede agregar la clave pública SSH después de crear la instancia.

        La propiedad displayName se utiliza para el nombre de instancia al utilizar el comando launch-compute-instance como se describe en Uso de una configuración de instancia para crear una instancia. Si no proporciona un valor para la propiedad displayName, el nombre por defecto de las instancias es instance YYYYMMDDhhmmss , donde YYYYMMDDhhmmss es la fecha y hora de creación.

        La propiedad displayName se ignora al crear instancias en un pool, como se describe en Creación de un pool de instancias.

      • El siguiente comando muestra las propiedades necesarias para crear una instancia:

        $ oci compute instance launch -h

        Desplácese a la sección Parámetros necesarios. Los parámetros opcionales se describen a continuación de los parámetros necesarios.

      Los nombres de las propiedades del archivo de configuración son similares, pero diferentes, a los nombres de las opciones instance launch. Además, algunas propiedades se organizan en grupos de propiedades, como createVnicDetails, shapeConfig y sourceDetails, como se muestra en el siguiente archivo de configuración de ejemplo:

      {
  "instanceType": "compute",
  "launchDetails": {
    "availabilityDomain": "AD-1",
    "compartmentId": "compartment_OCID",
    "createVnicDetails": {
      "assignPublicIp": true,
      "freeformTags": {
        "ConfigType": "Configuration for an XYZ instance."
      },
      "subnetId": "subnet_OCID"
    },
    "displayName": "instance_name",
    "instanceOptions": {
      "areLegacyImdsEndpointsDisabled": true
    },
    "metadata": {
      "ssh_authorized_keys": "public_SSH_key"
    },
    "shape": "shape_name",
    "shapeConfig": {
      "memoryInGBs": 512,
      "ocpus": 32
    },
    "sourceDetails": {
      "bootVolumeSizeInGBs": 100,
      "bootVolumeVpusPerGB": 20,
      "imageId": "image_OCID",
      "sourceType": "image"
    }
  }
}

      Utilice instanceOptions si necesita desactivar los puntos finales IMDSv1 para esta instancia. Consulte Recuperación de metadatos de instancia desde dentro de la instancia.

      Especifique la unidad flexible, VM.PCAStandard.E5.Flex, y también la configuración de la unidad. Debe proporcionar un valor para ocpus. La propiedad memoryInGBs es opcional; el valor por defecto en gigabytes es 16 veces el número de ocpus.

      Para obtener información sobre bootVolumeSizeInGBs, consulte "Tamaño de volumen de inicio" en el separador CLI Creación de una configuración de instancia a partir de una instancia.

      Para obtener información sobre bootVolumeVpusPerGB, consulte "Alto rendimiento" en el separador de la CLI Creación de una configuración de instancia a partir de una instancia. Cuando se inician instancias, el valor de bootVolumeVpusPerGB es null porque esta propiedad de volumen de inicio no se almacena en el objeto de instancia después de que se inicie la instancia. Para comprobar el valor, utilice el comando get boot volume y consulte el valor de vpus-per-gb.

      Para cambiar el valor de la propiedad firmware, proporcione un valor para la propiedad launchOptions. El valor por defecto es BIOS. También puede especificar UEFI_64. No se pueden cambiar otras propiedades de launchOptions.

      "launchOptions": {
  "bootVolumeType": "PARAVIRTUALIZED",
  "firmware": "UEFI_64",
  "isConsistentVolumeNamingEnabled": false,
  "isPvEncryptionInTransitEnabled": false,
  "networkType": "PARAVIRTUALIZED",
  "remoteDataVolumeType": "PARAVIRTUALIZED"
}

    3. Ejecute el comando de creación de configuración de instancia.

      Sintaxis:

      oci compute-management instance-configuration create -c <compartment_OCID> --display-name <IC_name> --instance-details file://<custom_config_file>.json

      El compartimento especificado es donde se crea esta configuración de instancia. Este compartimento puede ser diferente del compartimento especificado en el archivo JSON de detalles de la instancia, que es donde se crearán las instancias.

      El nombre mostrado especificado es el nombre de la configuración de la instancia. Si no proporciona un valor para la opción --display-name, el nombre por defecto de la configuración de instancia es instanceconfiguration YYYYMMDDhhmmss , donde YYYYMMDDhhmmss es la fecha y hora de creación.

      La salida de este comando es la misma que la salida del comando instance-configuration get.

  • Utilice la operación CreateInstanceConfiguration para crear una configuración de instancia introduciendo valores de configuración.

    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.