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 los valores de configuración de instancia individuales.

Nota

Si especifica un tamaño que sea mayor que el predeterminado, deberá ampliar el volumen para aprovechar el tamaño más grande. Consulte Resizing Volumes.

Evite introducir información confidencial en nombres y etiquetas.

Uso de imágenes de Marketplace

En Compute Cloud@Customer, la primera vez que crea una instancia mediante una imagen de Marketplace, debe utilizar la consola de Compute Cloud@Customer para que pueda 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 Imágenes de Marketplace.

    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 que se cree esta configuración de instancia.

      • Compartimento en el que crear instancias: seleccione el compartimento donde desea que se creen 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 incluir la instancia, el inicio de la instancia falla. 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 la plataforma Compute Cloud@Customer.
          • Imagen personalizada: se puede seleccionar si se ha creado una imagen personalizada. Puede que tenga que seleccionar el compartimento donde se encuentra la imagen personalizada. Consulte Gestión de imágenes personalizados.
          • 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 las imágenes de Marketplace están 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 situada 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 los encabezados 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 seleccionó Boot Volume (Volumen de inicio), verá una lista tabular con las columnas Name (Nombre), Size (GB) (Tamaño) y Created (Creado) (la fecha de creación del volumen de inicio). Puede utilizar las flechas de los encabezados 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 personalizado o una configuración de rendimiento de volumen.

        • Tamaño de volumen de inicio (GB): se muestra el tamaño de volumen de inicio predeterminado 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, 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, ampliar el sistema de archivos. Para otros sistemas operativos o para 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).

      • Subred: seleccione una subred.

        1. Seleccione una VCN en la lista. Puede que necesite 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 las instancias creadas con esta configuración de instancia, active la casilla Asignar IP pública para que se asigne una dirección IP pública a las instancias. Esta casilla está marcada de forma predeterminada si ha especificado una subred pública. Si no marca esta casilla o si desactiva esta casilla y, a continuación, desea asignar una dirección IP pública más adelante, consulte Asignación de una dirección IP pública efímera a una instancia para obtener instrucciones.

      • VNIC secundarias: (opcional) marque 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 Creating and Attaching a Secondary VNIC.

      • 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 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 para 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 Control de tráfico con grupos de seguridad de red 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 heredadas (/v1) del servicio de metadatos de instancia (IMDS) 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 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 el estado parado.

      • Etiquetado: (opcional) agregue una o más etiquetas a este recurso. Las etiquetas también se pueden aplicar más tarde. Para obtener más información sobre el etiquetado de recursos, consulte Adición de etiquetas en la creación de recursos (IAM en OCI).

    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 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 CLI, consulte la Referencia de línea de comando.

    Procedimiento

    1. Obtenga la siguiente información:

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

      • OCID del compartimento donde desea que se creen 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 al comando de creación de configuración.

      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 genera 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 único dominio de errores, todas las instancias se ubican únicamente 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 hacer 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 instancia. Para obtener más información, consulte Creación de un pool de instancias.

        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 está en uso para la subred".

        • La propiedad hostnameLabel se ignora cuando se utiliza 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 Asignación de una dirección IP pública efímera a una instancia para obtener instrucciones.

        Si los usuarios utilizarán 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 qué propiedades son 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 a los nombres de las opciones instance launch, pero diferentes de ellos. 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 especifique 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 predeterminado es el BIOS. También puede especificar UEFI_64. No se pueden cambiar otras propiedades en launchOptions.

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

    3. Ejecute el comando create 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 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 que introduzca 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.