Antes de empezar

• Descargue, instale e inicialice los siguientes plug-ins CLI.

  • IBM Cloud CLI
  • El plugin infrastructure-service

  Para obtener más información, consulte Configuración del entorno de API y de CLI.

• Asegúrese de haber creado una VPC.

Obtención de información para crear una instancia mediante la CLI

¿Preparado para crear una instancia? Antes de ejecutar el comando ibmcloud is instance-create, debe conocer los detalles de la instancia, como el perfil o la imagen que desea utilizar.

Recopila la siguiente información utilizando los comandos asociados.

Utilice los mandatos siguientes para determinar la información necesaria para crear una instancia nueva.

1. Obtenga una lista de las regiones asociadas a su cuenta.

   ibmcloud is regions
   

   Vea el ejemplo siguiente.

   $ ibmcloud is regions
   Listing regions under account Test Account as user test.user@ibm.com...
   Name       Endpoint                              Status
   au-syd     https://au-syd.iaas.cloud.ibm.com     available
   br-sao     https://br-sao.iaas.cloud.ibm.com     available
   ca-tor     https://ca-tor.iaas.cloud.ibm.com     available
   eu-de      https://eu-de.iaas.cloud.ibm.com      available
   eu-es      https://eu-es.iaas.cloud.ibm.com      available
   eu-gb      https://eu-gb.iaas.cloud.ibm.com      available
   jp-osa     https://jp-osa.iaas.cloud.ibm.com     available
   jp-tok     https://jp-tok.iaas.cloud.ibm.com     available
   us-east    https://us-east.iaas.cloud.ibm.com    available
   us-south   https://us-south.iaas.cloud.ibm.com   available
   

2. Conmute a la región de destino.

   ibmcloud target -r <region-name>
   

3. Enumera las zonas asociadas a la región de destino.

   ibmcloud is zones
   

   En el ejemplo siguiente, el mandato se ejecuta en la región us-south y la salida muestra las zonas disponibles en la región.

   $ ibmcloud is zones
   Listing zones in target region us-south under account Test Account as user test.user@ibm.com...
   Name         Region     Status
   us-south-1   us-south   available
   us-south-2   us-south   available
   us-south-3   us-south   available
   

4. Obtenga una lista de las IBM Cloud VPC asociadas a su cuenta.

   ibmcloud is vpcs
   

   Para este ejemplo, verá una respuesta similar a la siguiente salida.

   ID                                        Name       Status     Classic access   Default network ACL              Default security group        Resource group
   r006-35b9cf35-616e-462e-a145-cf8db4062fcf my-vpc     available  false            immortality-casing-extoll-exit   enhance-corsage-managing-jinx Default
   

   Si no dispone de una VPC, puede crear una utilizando el comando ibmcloud is vpc-create comando Para obtener más información sobre cómo crear una VPC, consulte ibmcloud is vpc-create.

5. Obtenga una lista de las subredes asociadas a la IBM Cloud VPC.

   ibmcloud is subnets
   

   Para este ejemplo, verá una respuesta similar a la siguiente salida.

   ID                                          Name            Status      Subnet CIDR      Addresses   ACL                              Public Gateway   VPC
   Zone         Resource group
   0717-198db988-3b9b-4cfa-9dec-0206420d37d0   my-subnet       available   10.240.64.0/28   7/16        immortality-casing-extoll-exit   -               my-vpc
   us-south-2   Default
   

   Si no dispone de una subred, puede crear una utilizando el comando ibmcloud is subnet-create comando Para obtener más información sobre la creación de una subred, consulte ibmcloud is subnet-create.

6. Obtenga una lista de los perfiles disponibles para crear la instancia.

   ibmcloud is instance-profiles
   

   Para este ejemplo, verá una respuesta similar a la siguiente salida.

   Name                         vCPU Manufacturer   Architecture   Family              vCPUs   Memory(GiB)   Bandwidth(Mbps)   Volume bandwidth(Mbps)   GPUs          Storage(GB)   Min NIC Count   Max NIC Count
   bx2-2x8                      intel               amd64          balanced            2       8             4000              1000                     -      -                    1               5
   bx2a-2x8                     amd                 amd64          balanced            2       8             2000              500                      -      -                    1               5
   bx2d-2x8                     intel               amd64          balanced            2       8             4000              1000                     -            1x75          1               5
   bx2-4x16                     intel               amd64          balanced            4       16            8000              2000                     -      -                    1               5
   bx2a-4x16                    amd                 amd64          balanced            4       16            4000              1000                     -      -                    1               5
   bx2d-4x16                    intel               amd64          balanced            4       16            8000              2000                     -            1x150         1               5
   

   Para obtener más información sobre los perfiles disponibles, consulte Perfiles de instancia dex86 y Perfiles de instancia des390x.

   Los perfiles habilitados para ejecución segura ya están disponibles y se identifican por el cuarto carácter del nombre del perfil que es una "e", como por ejemplo bz2e. Para obtener más información, consulte Informática confidencial con LinuxONE.

   Los perfiles habilitados para la ejecución segura están disponibles para las familias Balanced, Compute y Memory. Asegúrese de utilizar perfiles habilitados para la ejecución segura cuando utiliza la imagen de IBM Hyper Protect Container Runtime. La validación de perfiles para las imágenes en stock proporcionadas por IBMy el IBM Hyper Protect Container Runtime se produce en la capa RIAS. Cualquier discrepancia de perfil da como resultado un mensaje de error que es similar al ejemplo siguiente.

   FAILED
   Response HTTP Status Code: 400
   Error code: bad_field
   Error message: Image OS IBM Hyper Protect is not supported by the instance profile <profile_name>
   Error target name: profile, type: field
   

7. Liste las imágenes en stock disponibles, las imágenes personalizadas o las imágenes que se comparten con su cuenta desde un catálogo privado para crear la instancia. Si está creando una instancia a partir de un volumen de arranque existente, omita este paso.

   • Para listar todas las imágenes de stock o personalizadas disponibles, ejecute el siguiente comando.

     ibmcloud is images
     

     Para este ejemplo, verá una respuesta similar a la siguiente salida.

     ID                                          Name                               Status       Arch    OS name                   OS version       File size(GB)
     Visibility   Owner type   Encryption   Resource group   Catalog Offering
     r006-24d856e2-6aec-41c2-8f36-5a8a3766f0d6   ibm-centos-7-9-minimal-amd64-9     available    amd64   centos-7-amd64            7.x - Minimal Install  1             public       provider     none         Default          -
     r006-9768bb7f-c75d-4408-ba34-61015632f907   ibm-debian-10-13-minimal-amd64-2   available    amd64   debian-10-amd64           10.x Buster/Stable     1             public       provider     none         Default          -
     r006-f83ce520-00b5-40c5-9938-a5c82a273f91   ibm-debian-11-3-minimal-amd64-4    available    amd64   debian-11-amd64           11.x Bullseye/Stable   1
     

     Para obtener una lista completa de opciones de comando, consulte ibmcloud es imágenes.

     Las imágenes en desuso no incluyen el soporte más actualizado.

   • Para listar todas las imágenes disponibles compartidas desde un catálogo privado, ejecute los mandatos siguientes:

     Si selecciona una imagen de catálogo que pertenece a una cuenta diferente, tiene consideraciones y limitaciones adicionales que revisar. Consulte Utilización de referencias de imagen entre cuentas en un catálogo privado en la CLI

     • Para listar todas las ofertas de imágenes de catálogo privadas disponibles, ejecute el mandato siguiente.

       ibmcloud is catalog-image-offerings
       

       Este mandato devuelve el identificador de cada oferta de imagen y el identificador del catálogo privado donde se encuentra la imagen. Guarde offering_id y catalog_id en variables, que se utilizan posteriormente para suministrar una instancia.

       offering_id=6bf79f7b-de48-4ce8-8cae-866b376f2889
       catalog_id=71306253-8444-4cae-a45d-64d35e5393ec
       

     • Para obtener el offering_crn para la oferta y el offering_version_crn para cada versión de la oferta, ejecute el mandato siguiente.

       ibmcloud is catalog-image-offering $catalog_id $offering_id
       

     Al suministrar una instancia, puede suministrar la instancia desde la imagen gestionada por catálogo privada en la última versión de una oferta de producto de catálogo utilizando el valor offering_crn o desde la versión específica de la oferta de producto de catálogo utilizando el valor offering_version_crn.

     Guarde offering_crn y offering_version_crn en variables, que se utilizan posteriormente para suministrar una instancia.

     offering_crn="crn:v1:bluemix:public:globalcatalog-collection:global:a/a1234567:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d"
     offering_version_crn="crn:v1:bluemix:public:globalcatalog-collection:global:a/a1234567:0b322820-dafd-4b5e-b694-6465da6f008a:version:136559f6-4588-4af2-8585-f3c625eee09d/8ae92879-e253-4a7c-b09f-8d30af12e518"
     

8. Lista los volúmenes de arranque disponibles para crear su instancia. Si está creando una instancia a partir de una imagen, omita este paso Para crear una instancia a partir de un volumen existente, debe utilizar un volumen que sea compatible con las opciones de instancia elegidas anteriormente. Un volumen compatible está en la misma zona que la instancia que se está aprovisionando, no está asociado y tiene un sistema operativo compatible con el perfil seleccionado en el paso 5. Utilice el submandato volumes para ver los volúmenes compatibles. Por ejemplo, para ver volúmenes no conectados con una arquitectura de sistema operativo x64 en us-south-1:

   ibmcloud is volumes --attachment-state unattached --operating-system-architecture amd64 --zone us-south-1
   

9. Opcionalmente, puede crear un volumen de arranque a partir de una instantánea arrancable y utilizarlo para la imagen. Para listar todas las instantáneas de un volumen, consulte Ver todas las instantáneas creadas a partir del volumen Block Storage for VPC. Si tiene previsto utilizar una instantánea de otra cuenta, asegúrese primero de que dispone de las autorizaciones de IAM adecuadas. A continuación, ponte en contacto con el propietario de la instantánea para obtener el CRN de la misma.

10. Obtenga una lista de las claves SSH disponibles que puede asociar a la instancia.

    ibmcloud is keys
    

    Para este ejemplo, verá una respuesta similar a la siguiente salida.

    ID                                          Name     Type   Length   FingerPrint          Resource group
    r006-89ec781c-9630-4f76-b9c4-a7d204828d61   my-key   rsa    4096     gtnf+pdX2PYI9Ofq..   Default
    

    Si no dispone de una clave SSH, puede crear una clave SSH utilizando el comando ibmcloud is key-create. Para obtener más información, consulte Claves SSH.

11. Genere una lista de todos los grupos de colocación disponibles que puede asociar con la instancia.

ibmcloud is placement-groups

Para este ejemplo, verá una respuesta similar a la siguiente salida.

ID                                            Name                             State    Strategy       Resource Group
c5f1f366-b92a-4080-991a-aa5c2e33d96b          placement-group-region-us-south   stable   power_spread  Default

Creación de una instancia mediante la CLI

Utilice la información siguiente para crear una instancia con la CLI.

Suministrar desde una imagen en stock o personalizada

Una vez que conozca los valores necesarios, utilícelos para ejecutar el comando ibmcloud is instance-create comando. También es necesario especificar un nombre exclusivo para la instancia.

Utilice los pasos siguientes para crear una instancia de servidor virtual básica a partir de una imagen en stock utilizando la CLI. De forma predeterminada, se conecta un volumen de arranque a la instancia cuando se crea la instancia. Para la mayoría de instancias de servidor virtual, el tamaño de volumen de arranque predeterminado es de 100 GB. El tamaño de volumen de arranque predeterminado para una instancia de servidor virtual z/OS es de 250 GB.

1. Cree una instancia utilizando el mandato siguiente.

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --image IMAGE \
       --keys KEYS \
   

   Por ejemplo, el siguiente mandato instance-create utiliza los valores de ejemplo que se encuentran en la sección Recopilación de información.

   ibmcloud is instance-create \
       my-instance \
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf \
       us-south-2 \
       bx2-2x8 \
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0 \
       --image r006-f83ce520-00b5-40c5-9938-a5c82a273f91 \
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61 \
   

   Donde se utilizan los siguientes argumentos y valores de opción

   • NOMBRE_INSTANCIA: my-instance
   • VPC: r006-35b9cf35-616e-462e-a145-cf8db4062fcf
   • ZONE_NAME: us-south-2
   • NOMBRE_PERFIL: bx2-2x8
   • SUBRED: 0717-198db988-3b9b-4cfa-9dec-0206420d37d0
   • IMAGE: Debian 11 r006-f83ce520-00b5-40c5-9938-a5c82a273f91
   • CLAVES: r006-89ec781c-9630-4f76-b9c4-a7d204828d61

   La respuesta varía en función de los valores de opción que utilices.

   ID                                    0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Name                                  my-instance
   CRN                                   crn:v1:public:is:us-south-2:a/a1234567::instance:0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Status                                pending
   Availability policy on host failure   restart
   Startable                             true
   Profile                               bx2-2x8
   Architecture                          amd64
   vCPU Manufacturer                     intel
   vCPUs                                 2
   Memory(GiB)                           8
   Bandwidth(Mbps)                       4000
   Volume bandwidth(Mbps)                1000
   Network bandwidth(Mbps)               3000
   Lifecycle Reasons                     Code   Message
                                          -      -
   
   Lifecycle State                       pending
   
   Metadata service                      Enabled   Protocol   Response hop limit
                                         false     http       1
   
   Image                                 ID                                          Name
                                         r006-f83ce520-00b5-40c5-9938-a5c82a273f91   ibm-debian-11-3-minimal-amd64-4
   
   VPC                                   ID                                          Name
                                         r006-35b9cf35-616e-462e-a145-cf8db4062fcf   my-vpc
   
   Zone                                  us-south-2
   Resource group                        ID                                 Name
                                         cdc21b72d4e647b195de988b175e3d82   Default
   
   Created                               2023-03-23T21:50:24+00:00
   Boot volume                           ID   Name   Attachment ID                               Attachment name
                                         -    -      0717-7ccd4284-e59d-45d8-932a-9e52f62f187a   landing-faucet-prankish-sprout
   

   La información sobre las interfaces de red creadas para la nueva instancia no se devuelve una vez creada la instancia. Puede ver la información utilizando el mandato ibmcloud is instance INSTANCE tal como se describe en el paso siguiente. El estado muestra pendiente hasta que se crea la instancia.

   Para obtener más información sobre algunas características adicionales que puede incluir como opciones de mandato en el mandato instance-create, consulte los temas siguientes: Crear un JSON de adjunto de volumen, Habilitar o inhabilitar el servicio de metadatos y Creación de un grupo de colocación.

   Para obtener una lista completa de las opciones de mandatos, consulte ibmcloud is instance-create.

2. A continuación, ejecute el siguiente mandato de detalles de instance para verificar que puede ver la nueva instancia y ver las interfaces de red que se han creado para la nueva instancia. 0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0 es el ID de instancia de servidor virtual que se asignó cuando se creó la instancia en el paso anterior.

   ibmcloud is instance 0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   

   Para este ejemplo, puede ver la siguiente respuesta. El estado ahora muestra en ejecución. Compruebe la sección Interfaces de red para localizar el ID de la interfaz de red.

   ID                                    0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Name                                  my-instance
   CRN                                   crn:v1:public:is:us-south-2:a/a1234567::instance:0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Status                                running
   Availability policy on host failure   restart
   Startable                             true
   Profile                               bx2-2x8
   Architecture                          amd64
   vCPU Manufacturer                     intel
   vCPUs                                 2
   Memory(GiB)                           8
   Bandwidth(Mbps)                       4000
   Volume bandwidth(Mbps)                1000
   Network bandwidth(Mbps)               3000
   Lifecycle Reasons                     Code   Message
                                          -      -
   
   Lifecycle State                       stable
   
   Metadata service                      Enabled   Protocol   Response hop limit
                                         false     http       1
   
   Image                                 ID                                          Name
                                         r006-f83ce520-00b5-40c5-9938-a5c82a273f91   ibm-debian-11-3-minimal-amd64-4
   
   VPC                                   ID                                          Name
                                         r006-35b9cf35-616e-462e-a145-cf8db4062fcf   my-vpc
   
   Zone                                  us-south-2
   Resource group                        ID                                 Name
                                         cdc21b72d4e647b195de988b175e3d82   Default
   
   Created                               2023-03-23T21:50:24+00:00
   Network Interfaces                    Interface   Name      ID                                          Subnet            Subnet ID                                   Floating IP   Security Groups                 Allow source IP spoofing   Reserved IP
                                         Primary     primary   0717-4db768bb-65c3-4045-8712-523e62eeabd2   my-subnet   0717-198db988-3b9b-4cfa-9dec-0206420d37d0         -             enhance-corsage-managing-jinx   false                      10.240.64.10
   
   Boot volume                           ID                                          Name                           Attachment ID                                    Attachment name
                                         r006-7a1d72d1-56ac-438e-bf85-6c0173e3f9a6   expend-anger-whiff-jackknife   0717-7ccd4284-e59d-45d8-932a-9e52f62f187a        landing-faucet-prankish-sprout
   

3. Solicite una dirección IP flotante para asociarla con la instancia utilizando el siguiente mandato. El nombre que se especifica para la IP flotante es my-floatingip. 0717-4db768bb-65c3-4045-8712-523e62eeabd2 es el ID de la interfaz de red para la instancia de servidor virtual que se ha visualizado en el paso anterior.

   ibmcloud is floating-ip-reserve \
       my-floatingip \
       --nic 0717-4db768bb-65c3-4045-8712-523e62eeabd2
   

   Para este ejemplo, verá una respuesta similar a la siguiente salida.

   ID               r006-9b79b9bc-a2dc-4337-865a-57d9b9198b76
   Address          169.59.214.164
   Name             my-floatingip
   CRN              crn:v1:public:is:us-south-2:a/a1234567::floating-ip:r006-9b79b9bc-a2dc-4337-865a-57d9b9198b76
   Status           available
   Zone             us-south-2
   Created          2023-03-23T22:13:07+00:00
   Target           ID                                          Target type         Instance ID                                 Target interface name   Target interface private IP
                    0717-4db768bb-65c3-4045-8712-523e62eeabd2   network_interface   0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0   primary                 -
   
   
   Resource group   ID                                 Name
                    cdc21b72d4e647b195de988b175e3d82   Default
   

   Anote la IP flotante Address para utilizarla más adelante.

   Para obtener una lista completa de las opciones del comando, consulte ibmcloud is floating-ip-reserve.

¿Necesita más ayuda? Siempre puede ejecutar ibmcloud is instance-create --help para visualizar ayuda para crear una instancia.

Suministrar desde una imagen de catálogo privada

Una vez que conozca los valores necesarios, utilícelos para ejecutar el comando ibmcloud is instance-create comando. También es necesario especificar un nombre exclusivo para la instancia.

Utilice los pasos siguientes para crear una instancia de servidor virtual a partir de una oferta de catálogo privado o una versión de oferta de catálogo utilizando la CLI.

1. Cree una instancia utilizando el mandato siguiente.

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --catalog-offering <CRN for the IBM Cloud catalog offering> or --catalog-offering-version <The CRN for the version of an IBM Cloud catalog offering> \
       --keys KEYS \
       --placement-group PLACEMENT_GROUP_NAME \
   

   Por ejemplo, si crea una instancia llamada mi-instancia en us-south-2 y utiliza el perfil bx2-2x8 y la oferta de catálogo, su comando instance-create tendrá un aspecto similar al siguiente ejemplo.

   ibmcloud is instance-create\
       my-instance\
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf\
       us-south-2\
       bx2-2x8\
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0\
       --catalog-offering crn:v1:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61\
       --placement-group c5f1f366-b92a-4080-991a-aa5c2e33d96b\
   

   Donde se utilizan los siguientes valores de argumento y opción.

   • NOMBRE_INSTANCIA: my-instance
   • VPC: r006-35b9cf35-616e-462e-a145-cf8db4062fcf
   • ZONE_NAME: us-south-2
   • NOMBRE_PERFIL: bx2-2x8
   • SUBRED: 0717-198db988-3b9b-4cfa-9dec-0206420d37d0
   • CATALOG-OFFERING: es crn:v1:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d
   • CLAVES: r006-89ec781c-9630-4f76-b9c4-a7d204828d61
   • GRUPO_DE_COLOCACIÓN: c5f1f366-b92a-4080-991a-aa5c2e33d96b

   La información sobre las interfaces de red creadas para la nueva instancia no se devuelve una vez creada la instancia. Puede ver la información utilizando el mandato ibmcloud is instance INSTANCE tal como se describe en el paso siguiente.

   El estado de la instancia de servidor virtual muestra pending hasta que se crea la instancia.

   Para obtener una lista completa de las opciones de mandatos, consulte ibmcloud is instance-create.

2. A continuación, ejecute el siguiente mandato de detalles de instance para verificar que puede ver la nueva instancia y ver las interfaces de red que se han creado para la nueva instancia. Para INSTANCE, especifique el ID que se ha asignado a la nueva instancia de servidor virtual en el paso anterior.

   ibmcloud is instance INSTANCE
   

   El estado ahora muestra en ejecución. Compruebe la sección Interfaces de red para localizar el ID de la interfaz de red.

3. Solicite una dirección IP flotante para asociarla con la instancia utilizando el siguiente mandato. Para FLOATING_IP_NAME, especifique un nombre para la IP flotante y para TARGET_INTERFACE especifique el ID de la interfaz de red que ha identificado en el paso anterior.

   ibmcloud is floating-ip-reserve \
       FLOATING_IP_NAME \
       --nic TARGET_INTERFACE
   

   Anote la IP flotante Address para utilizarla más adelante.

   Para obtener una lista completa de las opciones del comando, consulte ibmcloud is floating-ip-reserve.

¿Necesita más ayuda? Siempre puede ejecutar ibmcloud is instance-create --help para visualizar ayuda para crear una instancia.

Suministrar desde un volumen existente

Una vez que conozca los valores necesarios, utilícelos para ejecutar el mandato instance-create. También es necesario especificar un nombre exclusivo para la instancia.

Utilice los pasos siguientes para crear una instancia de servidor virtual a partir de un volumen arrancable y que incluya una conexión de volumen.

1. Cree una instancia utilizando el mandato siguiente.

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --boot-volume VOLUME_ID \
       --keys KEYS \
       --volume-attach VOLUME_ATTACH_JSON \
   

   Por ejemplo, si crea una instancia llamada mi-instancia en us-south-1 y utiliza el perfil bx2-2x8 y un volumen de arranque existente, su comando instance-create tendrá un aspecto similar al siguiente ejemplo.

   ibmcloud is instance-create\
       my-instance\
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf\
       us-south-1\
       bx2-2x8\
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0\
       --boot-volume r006-feec3e99-995e-4e8f-896b-48b42c7d05a7\
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61\
       --volume-attach @/Users/myname/myvolume-attachment_create.json\
   

   Para ver un archivo JSON conectado a un volumen de ejemplo, consulte Creación de un archivo JSON de conexión de volumen. También puede incluir etiquetas de usuario para los volúmenes en la conexión de volumen.

   La información sobre las interfaces de red creadas para la nueva instancia no se devuelve una vez creada la instancia. Puede ver la información utilizando el mandato ibmcloud is instance INSTANCE tal como se describe en el paso siguiente.

   El estado muestra pendiente hasta que se crea la instancia.

   Para obtener una lista completa de las opciones de mandatos, consulte ibmcloud is instance-create.

2. A continuación, ejecute el siguiente mandato de detalles de instance para verificar que puede ver la nueva instancia y ver las interfaces de red que se han creado para la nueva instancia. Para INSTANCE, especifique el ID que se ha asignado a la nueva instancia de servidor virtual en el paso anterior.

   ibmcloud is instance INSTANCE
   

   El estado ahora muestra en ejecución. Compruebe la sección Interfaces de red para localizar el ID de la interfaz de red.

3. Solicite una dirección IP flotante para asociarla con la instancia utilizando el siguiente mandato. Para FLOATING_IP_NAME, especifique un nombre para la IP flotante y para TARGET_INTERFACE especifique el ID de la interfaz de red que ha identificado en el paso anterior.

   ibmcloud is floating-ip-reserve \
       FLOATING_IP_NAME \
       --nic TARGET_INTERFACE
   

   Anote la IP flotante Address para utilizarla más adelante.

   Para obtener una lista completa de las opciones del comando, consulte ibmcloud is floating-ip-reserve.

   ¿Necesita más ayuda? Siempre puede ejecutar ibmcloud is instance-create --help para visualizar ayuda para crear una instancia.

Crear una instancia con cómputo confidencial

Seleccionar disponibilidad

La informática confidencial con Intel SGX para VPC sólo está disponible en la región EE.UU.-Sur (Dallas).

Una vez que conozca los valores necesarios, utilícelos para ejecutar el mandato ibmcloud is instance-create. También es necesario especificar un nombre exclusivo para la instancia.

Para ' confidential-compute-mode, debe especificar ' sgx o ' tdx para la opción.

Siga los siguientes pasos para crear una instancia de servidor virtual básica que permita el cómputo confidencial.

Cree una instancia utilizando el mandato siguiente.

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --image IMAGE \
       --confidential-compute-mode sgx \
       --keys KEYS \

Por ejemplo, el siguiente mandato instance-create utiliza los valores de ejemplo que se encuentran en la sección Recopilación de información.

   ibmcloud is instance-create \
       my-instance \
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf \
       us-south-2 \
       bx2-2x8 \
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0 \
       --image r006-f83ce520-00b5-40c5-9938-a5c82a273f91 \
       --confidential-compute-mode sgx \
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61 \

Donde se utilizan los siguientes argumentos y valores de opción

  * INSTANCE_NAME: `my-instance`
  * VPC: `r006-35b9cf35-616e-462e-a145-cf8db4062fcf`
  * ZONE_NAME: `us-south-2`
  * PROFILE_NAME: `bx2-2x8`
  * SUBNET: `0717-198db988-3b9b-4cfa-9dec-0206420d37d0`
  * IMAGE: Debian 11 image `r006-f83ce520-00b5-40c5-9938-a5c82a273f91`
  * KEYS: `r006-89ec781c-9630-4f76-b9c4-a7d204828d61`

Crear una instancia con arranque seguro

Seleccionar disponibilidad

La informática confidencial con Intel SGX para VPC sólo está disponible en las regiones de Dallas (us-south) y Frankfurt (eu-de).

Una vez que conozca los valores necesarios, utilícelos para ejecutar el mandato ibmcloud is instance-create. También es necesario especificar un nombre exclusivo para la instancia.

Para " enable-secure-boot", debe especificar " true o " false. El valor predeterminado es false.

Siga estos pasos para crear una instancia básica de servidor virtual que permita el arranque seguro.

Cree una instancia utilizando el mandato siguiente.

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --image IMAGE \
       --enable-secure-boot true \
       --keys KEYS \

Por ejemplo, el siguiente mandato instance-create utiliza los valores de ejemplo que se encuentran en la sección Recopilación de información.

   ibmcloud is instance-create \
       my-instance \
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf \
       us-south-2 \
       bx2-2x8 \
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0 \
       --image r006-f83ce520-00b5-40c5-9938-a5c82a273f91 \
       --enable-secure-boot true \
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61 \

Donde se utilizan los siguientes argumentos y valores de opción

  * INSTANCE_NAME: `my-instance`
  * VPC: `r006-35b9cf35-616e-462e-a145-cf8db4062fcf`
  * ZONE_NAME: `us-south-2`
  * PROFILE_NAME: `bx2-2x8`
  * SUBNET: `0717-198db988-3b9b-4cfa-9dec-0206420d37d0`
  * IMAGE: Debian 11 image `r006-f83ce520-00b5-40c5-9938-a5c82a273f91`
  * KEYS: `r006-89ec781c-9630-4f76-b9c4-a7d204828d61`

Antes de empezar

Asegúrese de que dispone del acceso necesario. Para llamar a estos métodos, debe tener asignados uno o más roles de acceso de IAM que incluyan las acciones siguientes, en función de las condiciones listadas. Puede comprobar su acceso yendo a la página Usuarios del panel de control deCloud Identity and Access Management.

Recopilación de información para crear una instancia mediante la API

Para poder crear una instancia, debe conocer los detalles sobre la instancia, como el perfil de instancia o la imagen que desea utilizar. Recopile información realizando las siguientes llamadas de API:

Si tiene previsto utilizar una instantánea de otra cuenta, asegúrese primero de que dispone de las autorizaciones de IAM adecuadas. A continuación, ponte en contacto con el propietario de la instantánea para obtener el CRN de la misma.

Creación de una instancia mediante la API

Después de recuperar la información que necesita, puede ejecutar el método POST /instances para crear una instancia.

Suministrar una instancia a partir de una imagen en stock o personalizada utilizando la API

Puede suministrar una instancia con una imagen estándar o personalizada especificando la subpropiedad id de la imagen como el valor de la propiedad image.

   curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
     -H "Authorization:$iam_token" \
     -d '{
           "name": "my-instance",
           "zone": {
             "name": "us-south-3"
           },
           "vpc": {
             "id": "'$vpc'"
           },
           "primary_network_interface": {
             "subnet": {
               "id": "'$subnet'"
             }
           },
           "keys":[{"id": "'$key'"}],
           "profile": {
             "name": "'$profile_name'"
            },
           "image": {
             "id": "'$image_id'"
            }
           }'

Suministrar una instancia desde una imagen de catálogo privada utilizando la API

Puede suministrar una instancia con una imagen de catálogo privada especificando la subpropiedad offering_crn o version_crn de la imagen como valor de la propiedad catalog_offering.

• Cree una instancia utilizando una imagen de catálogo privada de la última versión de una oferta de producto de catálogo.

  curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
    -H "Authorization:$iam_token" \
    -d '{
          "name": "my-instance",
          "zone": {
            "name": "us-south-3"
          },
          "vpc": {
            "id": "'$vpc'"
          },
          "primary_network_interface": {
            "subnet": {
              "id": "'$subnet'"
            }
          },
          "keys":[{"id": "'$key'"}],
          "profile": {
            "name": "'$profile_name'"
           },
          "catalog_offering": {
            "offering": {
              "crn": "'$offering_crn'"
           }
          }'
  

• Cree una instancia utilizando una imagen de catálogo privada de una versión específica de una oferta de producto de catálogo.

  curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
    -H "Authorization:$iam_token" \
    -d '{
          "name": "my-instance",
          "zone": {
            "name": "us-south-3"
          },
          "vpc": {
            "id": "'$vpc'"
          },
          "primary_network_interface": {
            "subnet": {
              "id": "'$subnet'"
            }
          },
          "keys":[{"id": "'$key'"}],
          "profile": {
            "name": "'$profile_name'"
           },
          "catalog_offering": {
            "version": {
              "crn": "'$version_crn'"
           }
          }'
  

Suministrar desde un volumen existente

La reutilización de un volumen arrancable existente es más rápida que la creación de un nuevo volumen a partir de una instantánea o una imagen.

Puede suministrar una instancia con un volumen existente especificando la subpropiedad id o crn del volumen existente como valor de la propiedad boot_volume_attachment.

El volumen de arranque existente debe ser un volumen de arranque independiente que tenga la misma arquitectura que el perfil de instancia. Utilice el filtro list volumes y haga referencia a la propiedad attachment_state y a la propiedad operating_system para ver la elegibilidad de un volumen.

Por ejemplo, para ver volúmenes no conectados en us-south-1 con un sistema operativo x86.

curl -X GET "$vpc_api_endpoint/v1/volumes?version=2023-02-08&generation=2?attachment_state=unattached&zone.name=us-south-1&operating_system.architecture=amd64"
-H "Authorization: Bearer $iam_token"

De forma predeterminada, un volumen de arranque que se crea como parte del suministro de una instancia de servidor virtual se suprime cuando se suprime la instancia. Puede cambiar este comportamiento configurando el delete_volume_on_instance_delete propiedad a false cuando crea la instancia o actualiza el archivo adjunto del volumen de inicio.

Utilice el método POST /instances para crear una instancia con la información que ha recopilado. La llamada siguiente es un ejemplo de suministro de una instancia utilizando un volumen de arranque existente.

curl -X POST "$vpc_api_endpoint/v1/instances?version=2023-02-08&generation=2"
-H "Authorization: Bearer $iam_token"
-d '{
  "boot_volume_attachment": {
    "volume": {
      "id": "r006-feec3e99-995e-4e8f-896b-48b42c7d05a7"
    }
  },
  "keys": [
    {
      "id": "363f6d70-0000-0001-0000-00000013b96c"
    }
  ],
  "name": "my-instance",
  "placement_target": {
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"
  },
  "primary_network_interface": {
    "name": "my-network-interface",
    "subnet": {
      "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"
    }
  },
  "profile": {
    "name": "bx2-2x8"
  },
  "volume_attachments": [
    {
      "volume": {
        "capacity": 1000,
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "name": "my-data-volume",
        "profile": {
          "name": "5iops-tier"
        }
      }
    }
  ],
  "vpc": {
    "id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"
  },
  "zone": {
    "name": "us-south-1"
  }
}'

Para obtener más información, consulte Crear una instancia.

Restaurar un volumen de arranque a partir de una instantánea y utilizarlo para suministrar una nueva instancia

Puede restaurar un volumen de arranque desde una instantánea arrancable y, a continuación, utilizar ese volumen de arranque cuando suministre una instancia. La instantánea arrancable debe tener el mismo sistema operativo y arquitectura que el perfil de instancia.

En la solicitud POST /instances, especifique la propiedad boot_volume_attachment y el ID de instantánea arrancable en la subpropiedad source_snapshot. También puede utilizar el nombre o el CRN de la instantánea. Vea el ejemplo siguiente.

curl -X POST \
"$vpc_api_endpoint/v1/instances?version=2023-03-07&generation=2" \
-H "Authorization: $iam_token" \
-H "Content-Type: application/json" \
-d '{
      "boot_volume_attachment": {
        "delete_volume_on_instance_delete": true,
        "volume": {
            "profile": {
                "name": "general-purpose"
            },
            "source_snapshot": {
                "id": "eb373975-4171-4d91-81d2-c49efb033753"
            }
        }
     },
     .
     .
     .
  }'

Para obtener más información sobre la restauración de un volumen con la API, consulte Restaurar un volumen a partir de una instantánea con la API.

Creación de una instancia con cálculo confidencial

Seleccionar disponibilidad

La informática confidencial con Intel SGX para VPC sólo está disponible en las regiones de Dallas (us-south) y Frankfurt (eu-de).

Para aprovisionar una instancia con cálculo confidencial, añada la propiedad confidential_compute_mode y defínala como sgx o tdx.

   curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
     -H "Authorization:$iam_token" \
     -d '{
           "name": "my-instance",
           "zone": {
             "name": "us-south-3"
           },
           "vpc": {
             "id": "'$vpc'"
           },
           "primary_network_interface": {
             "subnet": {
               "id": "'$subnet'"
             }
           },
           "keys":[{"id": "'$key'"}],
           "profile": {
             "name": "'$profile_name'"
            },
           "image": {
             "id": "'$image_id'"
            },
            "confidential_compute_mode": "sgx"
           }'

Creación de una instancia con arranque seguro

Para aprovisionar una instancia con arranque seguro, añada la propiedad " enable_secure_boot " y ajústela a " true.

   curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
     -H "Authorization:$iam_token" \
     -d '{
           "name": "my-instance",
           "zone": {
             "name": "us-south-3"
           },
           "vpc": {
             "id": "'$vpc'"
           },
           "primary_network_interface": {
             "subnet": {
               "id": "'$subnet'"
             }
           },
           "keys":[{"id": "'$key'"}],
           "profile": {
             "name": "'$profile_name'"
            },
           "image": {
             "id": "'$image_id'"
            },
            "enable_secure_boot": "true"
           }'

Antes de empezar

Asegúrese de haber configurado Terraform for VPC.

Creación de un catálogo privado

Este campo es opcional. Si tiene previsto compartir imágenes de un catálogo privado, primero se debe crear el catálogo privado. Si selecciona una imagen de catálogo que pertenece a una cuenta diferente, revise Utilización de referencias de imagen entre cuentas en un catálogo privado en Terraform para obtener más consideraciones y limitaciones. Para crear un catálogo privado, consulte la guía de aprendizaje Incorporación de una imagen de servidor virtual con Terraform.

Recopilación de información para crear una instancia mediante Terraform

¿Preparado para crear una instancia? Antes de ejecutar el comando ibm_is_instance, debe conocer los detalles de la instancia, como el perfil o la imagen que desea utilizar.

Recopile la información siguiente utilizando el mandato DataSource.

1. Recopilar detalles de perfil de instancia. Ejecute el mandato siguiente para el perfil que seleccione. Consulte Perfiles de instancia dex86 para obtener una lista de los perfiles disponibles. Para obtener más información, consulte la documentación de Terraform sobre ibm_is_instance_profiles. Utilice un perfil de instancia haciendo referencia al origen de datos del perfil de instancia. Para obtener más información, consulte la documentación de Terraform sobre ibm_is_instance_profile.

   data "ibm_is_instance_profile" "example_profile" {
      name = "bx2-2x8"
   }
   

2. Obtenga una lista de las imágenes disponibles para crear la instancia. El mandato depende de la imagen que desee utilizar. Puede utilizar una imagen en stock, una imagen personalizada de su cuenta o una imagen que se ha compartido con su cuenta desde un catálogo privado. Para obtener más información, consulte la documentación de Terraform sobre ibm_is_image. Si tiene previsto utilizar una imagen que se ha compartido desde un catálogo privado, consulte la documentación de Terraform en ibm_cm_version o ibm_cm_offering_instance.

   • Seleccione una imagen en stock o una imagen personalizada de su cuenta para la instancia.

   data "ibm_is_image" "example_image" {
      name = "ibm-centos-7-6-minimal-amd64-2"
   }
   

   • Seleccione una imagen que se comparta desde un catálogo privado para la instancia. Para obtener más información, consulte la documentación de Terraform sobre ibm_is_images. Puede seleccionar una imagen de la lista para crear la instancia tal como se muestra en la sección Ir a Crear una instancia utilizando la sección Terraform.

   Si selecciona una imagen de catálogo que pertenece a una cuenta diferente, tiene más consideraciones y limitaciones que revisar. Consulte Utilización de referencias de imagen entre cuentas en un catálogo privado en Terraform.

   • Para listar todas las ofertas de imágenes de catálogo privadas disponibles, ejecute el mandato siguiente.

     data "ibm_is_images" "example_images" {
        catalog_managed = true
      }
     

3. Cree un recurso de VPC o utilice una VPC existente haciendo referencia al origen de datos de VPC. Para obtener más información, consulte la documentación de Terraform sobre ibm_is_vpc.

   resource "ibm_is_vpc" "example_vpc" {
      name = "example-vpc"
   }
   

4. Cree un recurso de subred o utilice una subred existente haciendo referencia al origen de datos de subred. Para obtener más información, consulte la documentación de Terraform sobre ibm_is_subnet.

   resource "ibm_is_subnet" "example_subnet" {
      name            = "example-subnet"
      vpc             = ibm_is_vpc.example_vpc.id
      zone            = "us-south-1"
      ipv4_cidr_block = "10.240.0.0/24"
   }
   

5. Cree un recurso ssh-key o utilice una ssh-key existente haciendo referencia al origen de datos ssh-key. Para obtener más información, consulte la documentación de Terraform en ibm_is_ssh_keys.

   resource "ibm_is_ssh_key" "example_sshkey" {
      name       = "example-sshkey"
      type       = "rsa"
      public_key = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCKVmnMOlHKcZK8tpt3MP1lqOLAcqcJzhsvJcjscgVERRN7/9484SOBJ3HSKxxNG5JN8owAjy5f9yYwcUg+JaUVuytn5Pv3aeYROHGGg+5G346xaq3DAwX6Y5ykr2fvjObgncQBnuU5KHWCECO/4h8uWuwh/kfniXPVjFToc+gnkqA+3RKpAecZhFXwfalQ9mMuYGFxn+fwn8cYEApsJbsEmb0iJwPiZ5hjFC8wREuiTlhPHDgkBLOiycd20op2nXzDbHfCHInquEe/gYxEitALONxm0swBOwJZwlTDOB7C6y2dzlrtxr1L59m7pCkWI4EtTRLvleehBoj3u7jB4usR"
   }
   

   Las claves SSH pueden ser RSA o Ed25519. Puede generar nuevos pares de claves RSA utilizando la interfaz de usuario. RSA preexistente y ED25519 Se pueden cargar claves SSH. Ed25519 solo se puede utilizar si el sistema operativo admite este tipo de clave. Ed25519 no se puede utilizar con imágenes de Windows o VMware.

6. Cree un recurso subnet_reserved_ip o utilice un subnet_reserved_ip existente haciendo referencia al origen de datos subnet_reserved_ip. Para más información, consulte la documentación de Terraform sobre ibm_is_subnet_reserved_ip

   resource "ibm_is_subnet_reserved_ip" "example_reserved_ip" {
      subnet    = ibm_is_subnet.example_subnet.id
      name      = "example-reserved-ip1"
      address   = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "13")}"
   }
   

Creación de una instancia mediante Terraform

Para utilizar Terraform, descargue Terraform CLI y configure el complemento IBM Cloud Provider. Para obtener más información, consulte Introducción a Terraform.

Cree la instancia utilizando uno de los ejemplos siguientes. Para obtener más información, consulte la documentación de Terraform sobre ibm_is_instance.

Ejecute uno de los siguientes mandatos de Terraform basándose en la imagen que tiene previsto utilizar.

• Cree una instancia utilizando una imagen en stock o una imagen personalizada de su cuenta para la instancia.

  resource "ibm_is_instance" "example_instance" {
    name    = "example-instance-reserved-ip"
    image   = data.ibm_is_image.example_image.id
    profile = data.ibm_is_instance_profile.example_profile.name
  
    primary_network_interface {
      name   = "eth0"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
      }
    }
    network_interfaces {
      name   = "eth1"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        name = "example-reserved-ip1"
        auto_delete = true
        address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
      }
    }
  
    vpc  = ibm_is_vpc.example_vpc.id
    zone = "us-south-1"
    keys = [ibm_is_ssh_key.example_sshkey.id]
  }
  

• Cree una instancia que utilice una imagen gestionada por catálogo privada.

  resource "ibm_is_instance" "example_instance" {
    name    = "example-instance-reserved-ip"
    image   = data.ibm_is_image.example_image.id
    profile = data.ibm_is_instance_profile.example_profile.name
  
    primary_network_interface {
      name   = "eth0"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
      }
    }
    network_interfaces {
      name   = "eth1"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        name = "example-reserved-ip1"
        auto_delete = true
        address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
      }
    }
  
    vpc  = ibm_is_vpc.example_vpc.id
    zone = "us-south-1"
    keys = [ibm_is_ssh_key.example_sshkey.id]
  }