Documentazione dell'infrastruttura Oracle Cloud

Creazione di una configurazione dell'istanza immettendo i valori di configurazione

In Compute Cloud@Customer, è possibile creare una configurazione dell'istanza immettendo i valori per le impostazioni di configurazione delle singole istanze.

Nota

Se si specifica una dimensione del volume di avvio maggiore di quella predefinita, è necessario estendere il volume per sfruttare la dimensione più grande. Vedere Ridimensionamento dei volumi.

Evitare di inserire informazioni riservate nei nomi e nelle etichette.

Utilizzo delle immagini del Marketplace

In Compute Cloud@Customer, la prima volta che crei un'istanza utilizzando un'immagine di Marketplace, devi utilizzare la console di Compute Cloud@Customer in modo da poter accettare l'accordo utente. Successivamente, puoi utilizzare la console, l'interfaccia CLI e l'API per creare istanze con un'immagine Marketplace.

Per mantenere l'integrità delle immagini del Marketplace, ci sono restrizioni e azioni consentite. Per ulteriori informazioni, vedere Immagini del Marketplace.

    1. Nel menu di navigazione della Console di Compute Cloud@Customer selezionare Computazione, quindi Configurazioni istanza.

    2. Selezionare Crea configurazione istanza.

    3. Nella finestra di dialogo Crea configurazione istanza immettere le informazioni riportate di seguito.

      • Nome: immettere un nome per la configurazione dell'istanza.

      • Crea nel compartimento: selezionare il compartimento in cui si desidera creare questa configurazione dell'istanza.

      • Compartimento in cui creare istanze: selezionare il compartimento in cui si desidera che vengano create le istanze.

      • Dominio di errore: (facoltativo) è possibile selezionare un dominio di errore. Per impostazione predefinita, il sistema seleziona automaticamente il dominio di errore migliore per le istanze. Se si specifica un dominio di errore e il dominio di errore richiesto non è in grado di soddisfare l'istanza, l'avvio dell'istanza non riesce. Vedere ulteriori informazioni sui domini di errore nella creazione di un'istanza.

      • Immagine di origine: selezionare un'immagine o un volume di avvio.

        1. Selezionare il tipo di origine:

          • Immagine della piattaforma: selezionare questa opzione per creare un'istanza basata su una delle immagini Oracle Linux e Oracle Solaris disponibili in ogni compartimento. Consulta Immagini della piattaforma Compute Cloud@Customer.
          • Immagine personalizzata: selezionabile se è stata creata un'immagine personalizzata. Potrebbe essere necessario selezionare il compartimento in cui si trova l'immagine personalizzata. Vedere Gestione di immagini personalizzate.
          • Volume di avvio: selezionare questa opzione per creare l'istanza in base a un volume di avvio esistente. Potrebbe essere necessario selezionare il compartimento in cui si trova il volume di avvio.
          • Immagine Marketplace: selezionabile se le immagini Marketplace sono disponibili in Compute Cloud@Customer. Vedere Immagini del Marketplace.

        2. Selezionare un'immagine o un volume di avvio dalla lista.

          Se è stata selezionata l'opzione Immagine piattaforma, viene visualizzata una lista in formato tabulare con le colonne Sistema operativo, Versione sistema operativo e Creazione immagine (la data di creazione dell'immagine). È possibile utilizzare la freccia del menu a discesa a destra della versione del sistema operativo per selezionare una versione diversa. Ad esempio, per il sistema operativo Oracle Linux, è possibile utilizzare il menu a discesa per selezionare 9, 8 o 7.9.

          Se è stata selezionata l'opzione Immagine personalizzata, viene visualizzato un elenco in formato tabella con le colonne Nome, Sistema operativo e Versione sistema operativo. È possibile utilizzare le frecce nelle intestazioni di colonna per ordinare l'elenco. È possibile filtrare l'elenco utilizzando il menu a discesa Sistema operativo sopra l'elenco di immagini.

          Se è stato selezionato Volume di avvio, viene visualizzata una lista di tabelle con le colonne Nome, Dimensione (GB) e Creato (la data di creazione del volume di avvio). È possibile utilizzare le frecce nelle intestazioni di colonna per ordinare l'elenco. Nella sezione Volume di boot (dopo la sezione Forma), è possibile personalizzare le dimensioni del volume di boot.

          Se l'elenco è troppo lungo per adattarsi a una vista, utilizzare i pulsanti freccia per visualizzare un'altra pagina dell'elenco.

          Per utilizzare un'immagine della piattaforma disponibile in precedenza ma non più elencata, utilizzare la console per creare l'istanza e specificare l'OCID dell'immagine.

          Se è stata selezionata un'immagine Marketplace, selezionare un'immagine Marketplace. Se è la prima volta che si crea un'istanza con questa immagine del Marketplace, viene visualizzato un pannello accordo. Prima di creare l'istanza, è necessario selezionare Accetta accordo e confermare l'accordo.

      • Forma: se si utilizza un'immagine della piattaforma, selezionare VM.PCAStandard.E5. Forma Flex e configura il numero di OCPU e memoria.

        Per i valori OCPU e memoria, selezionare all'interno di ogni campo di valori per visualizzare i valori minimo e massimo consentiti. La configurazione di OCPU e memoria può essere modificata dopo la creazione dell'istanza.

        Per una descrizione della forma supportata, vedere Forme di computazione.

      • Volume di avvio: (facoltativo) selezionare la casella di controllo per specificare un'impostazione personalizzata per le dimensioni o le prestazioni del volume di avvio.

        • Dimensione volume di avvio (GB): viene visualizzata la dimensione predefinita del volume di avvio per l'immagine selezionata. Per specificare una dimensione maggiore, immettere un numero intero di gigabyte fino a 16384 (16 TB) oppure utilizzare le frecce di incremento e decremento. Non è possibile inserire un valore inferiore alla dimensione predefinita.

          Se si specifica una dimensione del volume di avvio personalizzata, è necessario estendere la partizione per sfruttare le dimensioni maggiori. Le immagini della piattaforma Oracle Linux includono il pacchetto oci-utils. Utilizzare il comando oci-growfs del pacchetto per estendere la partizione root e quindi ingrandire il file system. Per altri sistemi operativi o per immagini personalizzate, attenersi alle istruzioni relative a tale sistema operativo.

        • Prestazioni del volume di boot (VPU): utilizzare le frecce di incremento e decremento per alternare prestazioni bilanciate (10 VPU/GB) e prestazioni elevate (20 VPU/GB).

      • Subnet: selezionare una subnet.

        1. Selezionare una VCN dalla lista. Potrebbe essere necessario modificare il compartimento nel compartimento in cui si trova la VCN.

        2. Selezionare una subnet.

      • Indirizzo IP pubblico: per utilizzare SSH per connettersi alle istanze create con questa configurazione dell'istanza, selezionare la casella Assegna IP pubblico per assegnare un indirizzo IP pubblico alle istanze. Questa casella è selezionata per impostazione predefinita se è stata specificata una subnet pubblica. Se non si seleziona questa casella o si deseleziona questa casella e si desidera assegnare un indirizzo IP pubblico in un secondo momento, vedere Assegnazione di un indirizzo IP pubblico effimero a un'istanza per le istruzioni.

      • VNIC secondarie: (facoltativo) selezionare la casella Crea VNIC aggiuntive per creare VNIC secondarie per le istanze create con questa configurazione dell'istanza. Per una descrizione delle informazioni richieste, vedere Creazione e collegamento di una VNIC secondaria.

      • Indirizzo IP privato: (facoltativo) specificare un indirizzo IP privato disponibile dal CIDR della subnet. Per impostazione predefinita, viene assegnato automaticamente un indirizzo IP privato.

        Nota

        Poiché l'indirizzo IP privato deve essere univoco per ogni istanza, non specificare un indirizzo IP privato se si intende utilizzare questa configurazione dell'istanza per creare un pool di istanze.

      • Record DNS: (facoltativo) selezionare la casella di controllo Assegna un record DNS privato per assegnare un record DNS alle istanze create con questa configurazione dell'istanza.

      • Nome host: (facoltativo) immettere un nome host se si utilizza il DNS nella rete cloud. Il nome host deve essere univoco in tutte le VNIC della subnet.

        Nota

        Non specificare un nome host se si intende utilizzare questa configurazione dell'istanza per creare un pool di istanze.

        Per impostazione predefinita, il nome dell'istanza viene utilizzato per il nome host. Il nome host può essere configurato anche nel sistema operativo dopo la creazione dell'istanza.

        Se si tratta di un'istanza UNIX, vedere Creazione di una destinazione di accesso e Attivazione di file system su istanze basate su UNIX per ulteriori informazioni sull'impostazione corretta del nome host per il MOUNT dei file system.

      • Chiavi SSH: per connettersi all'istanza utilizzando SSH, fornire una chiave SSH pubblica.

        Nota

        Impossibile fornire questa chiave SSH dopo la creazione dell'istanza.

      • Gruppo di sicurezza di rete: (facoltativo) per impostazione predefinita, le istanze non sono collegate ad alcun gruppo NSG. Selezionare la casella Abilita gruppo di sicurezza di rete per aggiungere la VNIC primaria per questa istanza a uno o più gruppi NSG.

        1. Selezionare un gruppo NSG dall'elenco a discesa. Potrebbe essere necessario modificare il compartimento per trovare il gruppo NSG desiderato.

        2. Selezionare Aggiungi gruppo di sicurezza di rete per collegarsi a un altro gruppo NSG.

        3. Per rimuovere un gruppo NSG dall'elenco, selezionare il cestino a destra di tale gruppo NSG. Per rimuovere l'ultimo gruppo NSG o tutti i gruppi NSG, deselezionare la casella Abilita gruppi di sicurezza di rete.

        Per informazioni sui gruppi NSG, vedere Controllo del traffico con i gruppi di sicurezza di rete.

      • Opzioni istanza: selezionare la casella per disabilitare gli endpoint del servizio metadati delle istanze precedenti. Per impostazione predefinita, gli instradamenti IMDS (Instance Metadata Service) legacy (/v1) sono abilitati. Se le applicazioni sono state aggiornate per utilizzare gli endpoint /v2, selezionare questa casella per disabilitare gli endpoint /v1. Per ulteriori informazioni su Instance Metadata Service, vedere Recupero dei metadati dell'istanza dall'interno dell'istanza. Per ulteriori informazioni sull'aggiornamento delle applicazioni, vedere Aggiornamento agli endpoint di IMDS versione 2.

      • Configurazione della disponibilità: (facoltativo) per impostazione predefinita, il sistema seleziona automaticamente l'opzione di disponibilità dell'istanza migliore durante un'operazione di manutenzione, ad esempio la migrazione attiva. Selezionare la casella Ripristina stato del ciclo di vita dell'istanza dopo la manutenzione dell'infrastruttura per specificare che le istanze in esecuzione devono essere riavviate automaticamente dopo un evento di manutenzione. Se questa casella non è selezionata, l'istanza viene recuperata con lo stato arrestato.

      • Applicazione di tag: (facoltativo) aggiungere una o più tag a questa risorsa. I tag possono essere applicati anche in seguito. Per ulteriori informazioni sull'applicazione di tag alle risorse, vedere Aggiunta di tag alla creazione di risorse (IAM in OCI).

    4. Selezionare Crea configurazione istanza.

  • Utilizzare il comando oci compute-management instance-configuration create e i parametri richiesti per creare una configurazione di istanza immettendo i valori di configurazione.

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

    Il compartimento specificato è il punto in cui viene creata questa configurazione dell'istanza. Questo compartimento potrebbe essere diverso dal compartimento specificato nel file JSON dei dettagli dell'istanza, dove verranno create le istanze.

    Il nome visualizzato specificato è il nome della configurazione dell'istanza. Se non si fornisce un valore per l'opzione --display-name, il nome predefinito della configurazione dell'istanza è instanceconfiguration YYYYMMDDhhmmss , dove YYYYMMDDhhmmss è la data e l'ora di creazione.

    Per un elenco completo di comandi, flag e opzioni dell'interfaccia CLI, vedere Riferimento per la riga di comando.

    Procedura

    1. Ottenere le informazioni seguenti:

      • OCID del compartimento in cui si desidera creare questa configurazione dell'istanza.

      • OCID del compartimento in cui si desidera creare le istanze che utilizzano questa configurazione di istanza.

      • Nome del dominio di disponibilità per le istanze che utilizzano questa configurazione dell'istanza.

      • OCID dell'immagine o del volume di avvio per le istanze che utilizzano questa configurazione dell'istanza.

      • Nome della forma per le istanze che utilizzano questa configurazione dell'istanza.

      • OCID della subnet per le istanze che utilizzano questa configurazione dell'istanza.

    2. Creare il file di configurazione che fornisce l'input per il comando di creazione della configurazione.

      Il file di configurazione è un file JSON di coppie proprietà/valore.

      • Utilizzare il comando seguente per generare la sintassi corretta del file di configurazione e dei nomi delle proprietà.

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

        Non sono necessari tutti i dati generati da questo comando. Copiare solo le informazioni necessarie, facendo attenzione a mantenere ogni proprietà nel suo contesto corretto.

        Se si omette la specifica del dominio di errore, il sistema seleziona automaticamente il dominio di errore migliore. Se si specifica un solo dominio di errore, tutte le istanze vengono inserite solo in tale dominio.

        Se un dominio di errore specificato non dispone di risorse sufficienti, le istanze potrebbero non riuscire ad eseguire le operazioni riportate di seguito.

        • Quando si crea una singola istanza (Uso di una configurazione dell'istanza per creare un'istanza) e si specifica un dominio di errore nella configurazione dell'istanza, viene utilizzato solo il dominio di errore specificato per creare l'istanza. I vincoli delle risorse potrebbero impedire l'avvio dell'istanza.

        • Quando si creano istanze in un pool, i domini di errore specificati nella configurazione di posizionamento sostituiscono i domini di errore specificati nella configurazione dell'istanza. Per ulteriori informazioni, vedere Creazione di un pool di istanze.

        È possibile specificare le VNIC e le subnet secondarie. Se si specifica un'etichetta nome host per una VNIC secondaria, l'etichetta nome host specificata deve essere univoca in tutte le VNIC della subnet. Se si fornisce un valore per la proprietà hostnameLabel, è necessario impostare anche il valore assignPrivateDnsRecord su true.

        • Se l'etichetta del nome host specificata è già in uso nella subnet, l'avvio dell'istanza (Uso di una configurazione dell'istanza per creare un'istanza) non riuscirà con l'errore "Nome host hostname già in uso per la subnet".

        • La proprietà hostnameLabel viene ignorata quando si utilizza la configurazione dell'istanza per creare un pool di istanze. Per impostazione predefinita, il nome dell'istanza viene utilizzato per il nome host.

        Se si omette la proprietà assignPublicIp, un indirizzo IP pubblico viene assegnato per impostazione predefinita se si specifica una subnet pubblica. Se si imposta questa proprietà su false e si decide di assegnare un indirizzo IP pubblico in un secondo momento, vedere Assegnazione di un indirizzo IP pubblico effimero a un'istanza per le istruzioni.

        Se gli utenti utilizzeranno ssh per connettersi all'istanza, specificare la chiave pubblica SSH come valore della proprietà ssh_authorized_keys nel blocco metadata. Impossibile aggiungere la chiave pubblica SSH dopo la creazione dell'istanza.

        La proprietà displayName viene utilizzata per il nome dell'istanza quando si utilizza il comando launch-compute-instance come descritto in Uso di una configurazione dell'istanza per creare un'istanza. Se non si fornisce un valore per la proprietà displayName, il nome predefinito delle istanze è instance YYYYMMDDhhmmss , dove YYYYMMDDhhmmss è la data e l'ora di creazione.

        La proprietà displayName viene ignorata quando si creano istanze in un pool, come descritto in Creazione di un pool di istanze.

      • Il comando seguente mostra le proprietà necessarie per creare un'istanza:

        $ oci compute instance launch -h

        Scorrere fino alla sezione Parametri obbligatori. I parametri facoltativi sono descritti sotto i parametri richiesti.

      I nomi delle proprietà nel file di configurazione sono simili ai nomi delle opzioni instance launch, ma diversi da quelli delle opzioni. Inoltre, alcune proprietà sono organizzate in gruppi di proprietà, ad esempio createVnicDetails, shapeConfig e sourceDetails, come mostrato nel file di configurazione di esempio riportato di seguito.

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

      Usare instanceOptions se è necessario disabilitare gli endpoint IMDSv1 per questa istanza. Vedere Recupero dei metadati dell'istanza dall'interno dell'istanza.

      Specificare la forma flessibile VM.PCAStandard.E5.Flex e specificare anche la configurazione della forma. Specificare un valore per ocpus. La proprietà memoryInGBs è facoltativa; il valore predefinito in gigabyte è 16 volte il numero di ocpus.

      Per informazioni su bootVolumeSizeInGBs, vedere "Dimensione del volume di boot" nella scheda CLI Creazione di una configurazione di istanza da un'istanza.

      Per informazioni su bootVolumeVpusPerGB, vedere "Prestazioni elevate" nella scheda CLI Creazione di una configurazione di istanza da un'istanza. Quando le istanze vengono avviate, il valore di bootVolumeVpusPerGB è null perché questa proprietà del volume di avvio non viene memorizzata nell'oggetto istanza dopo l'avvio dell'istanza. Per controllare il valore, utilizzare il comando get boot volume e vedere il valore di vpus-per-gb.

      Per modificare il valore della proprietà firmware, fornire un valore per la proprietà launchOptions. Il valore predefinito è BIOS. In alternativa, è possibile specificare UEFI_64. Impossibile modificare le altre proprietà in launchOptions.

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

    3. Eseguire il comando di creazione della configurazione istanza.

      Sintassi:

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

      Il compartimento specificato è il punto in cui viene creata questa configurazione dell'istanza. Questo compartimento potrebbe essere diverso dal compartimento specificato nel file JSON dei dettagli dell'istanza, dove verranno create le istanze.

      Il nome visualizzato specificato è il nome della configurazione dell'istanza. Se non si fornisce un valore per l'opzione --display-name, il nome predefinito della configurazione dell'istanza è instanceconfiguration YYYYMMDDhhmmss , dove YYYYMMDDhhmmss è la data e l'ora di creazione.

      L'output del comando è lo stesso dell'output del comando instance-configuration get.

  • Utilizzare l'operazione CreateInstanceConfiguration per creare una configurazione dell'istanza immettendo i valori di configurazione.

    Per informazioni sull'uso dell'API e sulle richieste di firma, vedere API REST e Credenziali di sicurezza. Per informazioni sugli SDK, vedere Software Development Kit and Command Line Interface (interfaccia a riga di comando e kit di sviluppo software).