Documentazione di Oracle Cloud Infrastructure

Creazione della configurazione di un'istanza mediante l'immissione dei valori di configurazione

In Compute Cloud@Customer, è possibile creare una configurazione di 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 maggiore. Vedere Ridimensionamento dei volumi.

Evitare di inserire informazioni riservate in nomi e tag.

Informazioni importanti sull'uso delle immagini di Marketplace per creare istanze

La prima volta che si crea un'istanza utilizzando un'immagine del Marketplace, è necessario 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 del Marketplace.

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

    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 di istanza.

      • Compartimento in cui creare le istanze: selezionare il compartimento in cui si desidera creare 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 può contenere l'istanza, l'avvio dell'istanza non riesce. Per ulteriori informazioni sui domini di errore, vedere Creazione di un'istanza.

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

        1. Selezionare 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. Vedere 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 delle 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 del Marketplace: selezionabile se le immagini del 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 visualizzato un elenco in formato tabulare con le colonne Sistema operativo, Versione sistema operativo e Creazione immagine (la data in cui è stata creata l'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 visualizzata una lista in formato tabulare 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 è stata selezionata l'opzione Volume di avvio, viene visualizzata una lista in formato tabulare 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 la dimensione del volume di boot.

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

          Per utilizzare un'immagine della piattaforma precedentemente disponibile 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 configurazione del 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 boot: (facoltativo) selezionare la casella per specificare un'impostazione personalizzata per la dimensione o le prestazioni del volume di boot.

        • Dimensione del 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. Impossibile inserire un valore inferiore alla dimensione predefinita.

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

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

      • Subnet: selezionare una subnet.

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

        2. Selezionare una sottorete.

      • Indirizzo IP pubblico: per utilizzare SSH per connettersi alle istanze create con questa configurazione dell'istanza, selezionare la casella Assegna IP pubblico in modo che alle istanze sia assegnato un indirizzo IP pubblico. 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 istruzioni.

      • VNIC secondarie: (facoltativo) selezionare la casella Crea VNIC aggiuntive per creare VNIC secondarie per le istanze create con questa configurazione di 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, un indirizzo IP privato viene assegnato automaticamente.

        Nota

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

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

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

        Nota

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

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

        Se si tratta di un'istanza UNIX, vedere Creazione di una destinazione di accesso e Attivazione dei file system su istanze basate su UNIX per ulteriori informazioni sull'impostazione corretta del nome host per l'attivazione 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 dell'istanza precedente. 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 di controllo per disabilitare gli endpoint /v1. Per ulteriori informazioni sul servizio metadati istanza, vedere Recupero dei metadati dell'istanza dall'interno dell'istanza. Per ulteriori informazioni sull'aggiornamento delle applicazioni, vedere Aggiornamento agli endpoint 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 in tempo reale. 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 nello stato arrestato.

      • Applicazione di tag: (facoltativo) aggiungere una o più tag a questa risorsa. Le tag possono essere applicate anche in seguito. Per ulteriori informazioni sull'applicazione di tag alle risorse, vedere Tag delle risorse.

    4. Selezionare Crea configurazione istanza.

  • Utilizzare il comando oci compute-management instance-configuration create e i parametri necessari per creare una configurazione dell'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, ovvero la posizione in cui 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 dei comandi, dei flag e delle opzioni dell'interfaccia CLI, vedere Command Line Reference.

    Procedura

    1. Recupera le seguenti informazioni:

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

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

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

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

    2. Creare il file di configurazione che fornisce l'input al comando configuration create.

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

      • Usare il comando seguente per generare la sintassi corretta del file di configurazione e i nomi delle proprietà:

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

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

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

        Se un dominio di errore specificato non dispone di risorse sufficienti, l'avvio delle istanze potrebbe non riuscire:

        • 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, per creare l'istanza viene utilizzato solo il dominio di errore specificato. I vincoli delle risorse potrebbero impedire l'avvio dell'istanza.

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

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

        • Se l'etichetta del nome host specificato è già in uso nella subnet, l'avvio dell'istanza (Utilizzo 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, per il nome host viene utilizzato il nome dell'istanza.

        Se si omette la proprietà assignPublicIp, per impostazione predefinita viene assegnato un indirizzo IP pubblico 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 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 Utilizzo 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 nella sezione Creazione di un pool di istanze.

      • Il comando seguente mostra quali proprietà sono 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, ma diversi, ai nomi delle opzioni instance launch. Alcune proprietà sono inoltre 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"
    }
  }
}

      Utilizzare 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, nonché 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. Le altre proprietà in launchOptions non possono essere modificate.

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

    3. Eseguire il comando di creazione della configurazione dell'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, ovvero la posizione in cui 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 di questo comando è uguale all'output del comando instance-configuration get.

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

    Per informazioni sull'uso dell'API e delle richieste di firma, vedere API REST e Credenziali di sicurezza. Per informazioni sugli SDK, vedere Software Development Kits and Command Line Interface.