Configurando indirizzi IP stateful in un gruppo di istanze gestite, assicurati che gli indirizzi IP vengano conservati quando le istanze VM nel gruppo vengono riparate automaticamente, aggiornate e ricreate.
Puoi conservare gli indirizzi IPv4 interni ed esterni. Puoi configurare gli indirizzi IP in modo che vengano assegnati automaticamente o assegnare indirizzi IP specifici a ogni istanza VM in un gruppo di istanze gestite.
Prima di iniziare
- Scopri quando utilizzare i gruppi di istanze gestite stateful e come funzionano.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
Gli indirizzi IPv6 non sono supportati.
Gli indirizzi IP interni non sono supportati nelle reti senza subnetwork, ad esempio le reti legacy.
- Non puoi utilizzare la scalabilità automatica se il gruppo di istanze gestite ha una configurazione stateful.
- Se vuoi utilizzare gli aggiornamenti incrementali automatici, devi impostare il metodo di sostituzione su
RECREATE
. - Per i gruppi di istanze gestite regionali stateful, devi
disattivare la ridistribuzione proattiva
(imposta il tipo di ridistribuzione su
NONE
) per impedire l'eliminazione delle istanze stateful tramite la ridistribuzione automatica tra zone. - Se utilizzi una configurazione per tutte le istanze per eseguire l'override delle proprietà del modello di istanza, non puoi specificarle in nessuna configurazione per istanza e contemporaneamente nella configurazione per tutte le istanze del gruppo.
- La tua applicazione richiede che un indirizzo IP rimanga statico dopo essere stato assegnato, ad esempio Kafka.
- La configurazione dell'applicazione dipende da indirizzi IP specifici, ad esempio un server DNS.
- Gli utenti, incluse altre applicazioni, accedono al server tramite un indirizzo IP statico dedicato, ad esempio un file server.
- Devi eseguire la migrazione dei carichi di lavoro esistenti senza modificare la configurazione di rete.
- La tua applicazione richiede che un indirizzo IP rimanga statico dopo essere stato assegnato. Tuttavia, la tua applicazione non richiede l'assegnazione di indirizzi IP specifici a istanze specifiche. Gli indirizzi IP possono essere assegnati automaticamente al momento della creazione dell'istanza.
- Gli utenti, incluse altre applicazioni, accedono ai tuoi server tramite indirizzi IP statici che pubblichi dopo aver eseguito il deployment dell'applicazione.
- Vuoi usufruire della riparazione automatica e degli aggiornamenti automatici delle istanze, mantenendo al contempo l'indirizzo IP statico assegnato automaticamente al momento della creazione dell'istanza.
- Per le nuove istanze, il gruppo di istanze gestite assegna e riserva automaticamente indirizzi IP statici.
- Per le istanze esistenti, il gruppo di istanze mig promuove gli indirizzi IP temporanei interni o esterni in uso ad indirizzi statici prenotando gli indirizzi IP statici corrispondenti.
Per le istanze esistenti senza indirizzi IP esterni, il gruppo di istanze gestite assegna e preleva indirizzi IP statici e aggiunge la configurazione di accesso all'interfaccia di rete corrispondente con i seguenti valori predefiniti:
"accessConfigs": [ { "kind": "compute#accessConfig", "name": "External NAT", "natIP": "XX.XX.XX.XX", "networkTier": "PREMIUM", "type": "ONE_TO_ONE_NAT" } ]
Nella console Google Cloud, vai alla pagina Gruppi di istanze.
Seleziona il progetto e fai clic su Continua.
Fai clic su Crea gruppo di istanze.
Seleziona Nuovo gruppo di istanze gestite (stateful).
Specifica un Nome per il gruppo di istanze.
Seleziona un modello di istanza.
In Numero di istanze, specifica il numero di istanze che vuoi includere nel gruppo di istanze gestite.
In Configurazione stateful, espandi l'IP esterno e l'IP interno che vuoi rendere stateful.
- In Stateful, seleziona Sì.
- Dal menu a discesa Con l'eliminazione definitiva dell'istanza, seleziona l'azione da eseguire sull'indirizzo IP stateful quando l'istanza VM viene eliminata. Le opzioni disponibili sono:
- Scollega IP: (valore predefinito). Annullare l'assegnazione dell'indirizzo all'eliminazione dell'istanza e mantenere l'indirizzo riservato.
- Elimina IP: elimina la prenotazione dell'indirizzo IP statico quando un'istanza viene eliminata definitivamente dal gruppo di istanze, ad esempio quando elimini un'istanza manualmente o diminuisci le dimensioni del gruppo.
- Al termine della configurazione con stato, fai clic su Fine.
Fai clic su Crea.
--stateful-internal-ip
per contrassegnare un indirizzo IP interno di una determinata interfaccia di rete come stateful.--stateful-external-ip
per contrassegnare un indirizzo IP esterno di una determinata interfaccia di rete come stateful.- INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite da creare.
- INSTANCE_TEMPLATE: il nome del modello di istanza da utilizzare при создании новых экземпляров.
- SIZE: il numero iniziale di istanze necessarie in questo gruppo.
- NI_NAME: (facoltativo) Nome dell'interfaccia di rete. Se non viene fornita,
l'opzione
enabled
è obbligatoria e per impostazione predefinita viene presupposta l'interfaccia di rete principale denominatanic0
. Se hai più interfacce di rete, puoi specificare questo flag per ogni IP in ogni interfaccia di rete. DELETE_RULE: (facoltativo) Stabilisce cosa deve succedere alla risorsa Indirizzo statica associata quando un'istanza VM viene eliminata definitivamente. Le opzioni disponibili sono le seguenti:
never
: (valore predefinito). Non eliminare mai l'indirizzo IP statico. Al contrario, scollega l'indirizzo all'eliminazione dell'istanza e mantieni l'indirizzo riservato.on-permanent-instance-deletion
: elimina la prenotazione dell'indirizzo IP statico quando un'istanza viene eliminata definitivamente dal gruppo di istanze, ad esempio quando elimini un'istanza manualmente o diminuisci le dimensioni del gruppo.
Indipendentemente dal valore della regola di eliminazione, il gruppo conserva sempre gli indirizzi IP stateful nelle operazioni di riparazione automatica, aggiornamento e ricreazione delle istanze.
stateful_internal_ip
per contrassegnare come stateful un indirizzo IP interno di una determinata interfaccia di rete.stateful_external_ip
per contrassegnare un indirizzo IP esterno di una determinata riga di istruzione di associazione di rete come stateful.- PROJECT: l'ID progetto per la richiesta.
- REGION: per i gruppi di istanze gestite a livello di regione, la
regione in cui si trova il gruppo. Per i gruppi di istanze gestite a livello di zona, sostituisci
regions/REGION
conzones/ZONE
e specifica la zona in cui si trova il gruppo di istanze gestite. - NAME: il nome del gruppo di istanze gestite da creare.
- INSTANCE_TEMPLATE: il nome del modello di istanza da utilizzare quando crei nuove istanze.
- SIZE: il numero iniziale di istanze necessarie in questo gruppo.
- NI_NAME: (facoltativo) Nome dell'interfaccia di rete. Se non viene fornita, è obbligatoria l'opzione
enabled
e per impostazione predefinita viene considerata l'interfaccia di rete principale denominatanic0
. Se hai più interfacce di rete, puoi specificare più NI_NAMES. DELETE_RULE: (facoltativo) prescrive cosa deve accadere a una risorsa Address statica associata quando un'istanza VM viene eliminata definitivamente. Le opzioni disponibili sono le seguenti:
NEVER
: (valore predefinito) non eliminare mai l'indirizzo IP statico. Al contrario, scollega l'indirizzo all'eliminazione dell'istanza e mantieni l'indirizzo riservato.ON_PERMANENT_INSTANCE_DELETION
: elimina la prenotazione dell'indirizzo IP statico quando un'istanza viene eliminata definitivamente dal gruppo di istanze, ad esempio quando elimini un'istanza manualmente o diminuisci le dimensioni del gruppo.
Indipendentemente dal valore della regola di eliminazione, il gruppo conserva sempre gli indirizzi IP stateful nelle operazioni di riparazione automatica, aggiornamento e ricreazione delle istanze.
- Configura gli indirizzi IP come stateful per tutte le istanze esistenti e future nel gruppo. In questo modo, gli indirizzi IP temporanei corrispondenti di tutte le istanze esistenti vengono promossi a indirizzi IP statici.
- Aggiorna la configurazione stateful esistente per gli indirizzi IP.
Nella console Google Cloud, vai alla pagina Gruppi di istanze.
Fai clic sul nome del gruppo di istanze per cui vuoi specificare gli indirizzi IP stateful.
Fai clic su Modifica per modificare il gruppo di istanze gestite.
In Configurazione stateful, espandi l'IP esterno e l'IP interno che vuoi rendere stateful.
- In Stateful, seleziona Sì.
- Dal menu a discesa Con l'eliminazione definitiva dell'istanza, seleziona l'azione da eseguire sull'indirizzo IP stateful quando l'istanza VM viene eliminata. Le opzioni disponibili sono:
- Scollega IP: (valore predefinito). Annullare l'assegnazione dell'indirizzo all'eliminazione dell'istanza e mantenere l'indirizzo riservato.
- Elimina IP: elimina la prenotazione dell'indirizzo IP statico quando un'istanza viene eliminata definitivamente dal gruppo di istanze, ad esempio quando elimini un'istanza manualmente o diminuisci le dimensioni del gruppo.
- Dopo aver aggiornato la configurazione con stato, fai clic su Fine.
- Fai clic su Salva per completare l'aggiornamento.
- INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite da aggiornare.
- NI_NAME: (facoltativo) Nome dell'interfaccia di rete. Se non viene fornita,
l'opzione
enabled
è obbligatoria e per impostazione predefinita viene presupposta l'interfaccia di rete principale denominatanic0
. Se hai più interfacce di rete, puoi specificare questo flag per ogni IP in ogni interfaccia di rete. DELETE_RULE: (facoltativo) Stabilisce cosa deve succedere a una risorsa Indirizzo statica associata quando un'istanza VM viene eliminata definitivamente. Le opzioni disponibili sono le seguenti:
never
: (valore predefinito). Non eliminare mai l'indirizzo IP statico. Al contrario, scollega l'indirizzo all'eliminazione dell'istanza e mantieni l'indirizzo riservato.on-permanent-instance-deletion
: elimina la prenotazione dell'indirizzo IP statico quando un'istanza viene eliminata definitivamente dal gruppo di istanze, ad esempio quando elimini un'istanza manualmente o diminuisci le dimensioni del gruppo.
Indipendentemente dal valore della regola di eliminazione, il gruppo conserva sempre gli indirizzi IP stateful nelle operazioni di riparazione automatica, aggiornamento e ricreazione delle istanze.
- PROJECT: l'ID progetto per la richiesta.
- REGION: per i gruppi di istanze gestite a livello di regione, la
regione in cui si trova il gruppo. Per i gruppi di istanze gestite a livello di zona, sostituisci
regions/REGION
conzones/ZONE
e specifica la zona in cui si trova il gruppo di istanze gestite. - NAME: il nome del gruppo di istanze gestite da creare.
- NI_NAME: (obbligatorio) nome dell'interfaccia di rete. L'interfaccia di rete principale si chiama
nic0
. Se hai più interfacce di rete, puoi specificare più NI_NAMES. DELETE_RULE: (facoltativo) prescrive cosa deve accadere a una risorsa Address statica associata quando un'istanza VM viene eliminata definitivamente. Le opzioni disponibili sono le seguenti:
NEVER
: (valore predefinito) non eliminare mai l'indirizzo IP statico. Al contrario, scollega l'indirizzo all'eliminazione dell'istanza e mantieni l'indirizzo riservato.ON_PERMANENT_INSTANCE_DELETION
: elimina la prenotazione dell'indirizzo IP statico quando un'istanza viene eliminata definitivamente dal gruppo di istanze, ad esempio quando elimini un'istanza manualmente o diminuisci le dimensioni del gruppo.
Indipendentemente dal valore della regola di eliminazione, il gruppo conserva sempre gli indirizzi IP stateful nelle operazioni di riparazione automatica, aggiornamento e ricreazione delle istanze.
- Ristruttura l'app in modo che non si basi più su indirizzi IP statici.
- Hai configurato l'IP come stateful per errore e vuoi ripristinarlo.
- In che modo la rimozione di una risorsa dal criterio stateful influisce sullo stato conservato.
- Applicazione di aggiornamenti dei criteri con stato.
Nella console Google Cloud, vai alla pagina Gruppi di istanze.
Fai clic sul nome del gruppo di istanze da cui vuoi rimuovere la configurazione stateful per gli indirizzi IP.
Fai clic su Modifica per modificare il gruppo di istanze gestite.
In Configurazione con stato, espandi l'IP esterno e l'IP interno che vuoi rendere senza stato.
- Imposta l'opzione Stateful su No.
- Fai clic su Fine.
Dopo aver apportato le modifiche, fai clic su Salva.
- INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite da aggiornare.
- NI_NAME: (obbligatorio) Nome dell'interfaccia di rete. L'interfaccia di rete principale si chiama
nic0
. Se hai più interfacce di rete, puoi specificare più NI_NAMES. - PROJECT: l'ID progetto per la richiesta.
- REGION: per i gruppi di istanze gestite a livello di regione, la
regione in cui si trova il gruppo. Per i gruppi di istanze gestite a livello di zona, sostituisci
regions/REGION
conzones/ZONE
e specifica la zona in cui si trova il gruppo di istanze gestite. - INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite da creare.
- NI_NAME: (obbligatorio) nome dell'interfaccia di rete. L'interfaccia di rete principale si chiama
nic0
. Se hai più interfacce di rete, puoi specificare più NI_NAMES. - Esegui la migrazione dei carichi di lavoro esistenti (trasferendo gli indirizzi IP statici riservati esistenti) dalle istanze VM autonome ai gruppi di istanze gestite stateful per usufruire della riparazione automatica e degli aggiornamenti automatici.
- Assegna indirizzi IP statici riservati specifici richiesti dall'architettura o dalla configurazione del carico di lavoro.
- Crea una prenotazione di indirizzi IP statici interni o esterni per gli indirizzi IP forniti, se non esistono ancora.
- Crea un'istanza dal modello di istanza utilizzando il nome e gli indirizzi IP dell'istanza forniti.
- Crea una configurazione per istanza con la configurazione stateful fornita per gli indirizzi IP.
--stateful-internal-ip
per impostare un indirizzo IP interno statico di una determinata interfaccia di rete.--stateful-external-ip
per impostare un indirizzo IP esterno statico di una determinata interfaccia di rete.- INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite.
- INSTANCE_NAME: il nome dell'istanza da creare.
- NI_NAME: (facoltativo) Nome dell'interfaccia di rete. Se non viene fornita, per impostazione predefinita viene assunta l'interfaccia di rete principale denominata
nic0
. Se hai più interfacce di rete, puoi specificare questo flag per ogni IP in ogni interfaccia di rete. ADDRESS: (obbligatorio). Indirizzo IP statico da assegnare all'istanza in uno dei seguenti formati:
- Indirizzo. URL di una prenotazione di un indirizzo IP statico, ad esempio:
"projects/example-project/regions/us-east1/addresses/example-ip-name"
. - Letterale, ad esempio:
"130.211.181.55"
.- Se l'indirizzo IP fornito non è ancora prenotato, il MIG crea automaticamente una prenotazione dell'indirizzo IP corrispondente.
- Se l'indirizzo IP fornito è riservato, il gruppo di istanze gestite assegna la prenotazione all'istanza.
- Indirizzo. URL di una prenotazione di un indirizzo IP statico, ad esempio:
DELETE_RULE: (facoltativo) Stabilisce cosa deve succedere a una risorsa Indirizzo statica associata quando un'istanza VM viene eliminata definitivamente. Le opzioni disponibili sono le seguenti:
never
: (valore predefinito). Non eliminare mai l'indirizzo IP statico. Al contrario, scollega l'indirizzo all'eliminazione dell'istanza e mantieni l'indirizzo riservato.on-permanent-instance-deletion
: elimina la prenotazione dell'indirizzo IP statico quando un'istanza viene eliminata definitivamente dal gruppo di istanze, ad esempio quando elimini un'istanza manualmente o diminuisci le dimensioni del gruppo.
Indipendentemente dal valore della regola di eliminazione, il gruppo conserva sempre gli indirizzi IP stateful nelle operazioni di riparazione automatica, aggiornamento e ricreazione delle istanze.
preserved_state.internal_ip
per contrassegnare un indirizzo IP interno di una determinata interfaccia di rete come stateful.preserved_state.external_ip
per contrassegnare un indirizzo IP esterno di una determinata interfaccia di rete come stateful.- PROJECT_ID: l'ID progetto per la richiesta.
- NAME: il nome del gruppo di istanze gestite.
- REGION: per i gruppi di istanze gestite a livello di regione, la
regione in cui si trova il gruppo. Per i gruppi di istanze gestite a livello di zona, sostituisci
regions/REGION
conzones/ZONE
e specifica la zona in cui si trova il gruppo di istanze gestite. - INSTANCE_NAME: il nome dell'istanza da creare.
- NI_NAME: (obbligatorio) Nome dell'interfaccia di rete. L'interfaccia di rete principale si chiama
nic0
. Se hai più interfacce di rete, puoi specificare più NI_NAMES. - ADDRESS: (facoltativo) Indirizzo IP statico da assegnare all'istanza nel formato di un URL di una prenotazione di indirizzo IP statico, ad esempio
"projects/example-project/regions/us-east1/addresses/example-ip-name"
. Quando assegni un indirizzo IP statico, devi e puoi impostare un solo campo alla volta,address
oliteral
. - LITERAL: (facoltativo) Indirizzo IP statico da assegnare all'istanza nel formato letterale, ad esempio:
"130.211.181.55"
. Quando assegni un indirizzo IP statico, devi e puoi impostare un solo campo alla volta,address
oliteral
.- Se l'indirizzo IP letterale fornito non è ancora prenotato, il MIG crea automaticamente una prenotazione dell'indirizzo IP corrispondente.
- Se l'indirizzo IP letterale fornito è riservato, il gruppo di istanze gestite assegna la prenotazione all'istanza.
DELETE_RULE: (facoltativo) Stabilisce cosa deve succedere a una risorsa Indirizzo statica associata quando un'istanza VM viene eliminata definitivamente. Le opzioni disponibili sono le seguenti:
NEVER
: (valore predefinito). Non eliminare mai l'indirizzo IP statico. Al contrario, scollega l'indirizzo all'eliminazione dell'istanza e mantieni l'indirizzo riservato.ON_PERMANENT_INSTANCE_DELETION
: elimina la prenotazione dell'indirizzo IP statico quando un'istanza viene eliminata definitivamente dal gruppo di istanze, ad esempio quando elimini un'istanza manualmente o diminuisci le dimensioni del gruppo.
Indipendentemente dal valore della regola di eliminazione, il gruppo conserva sempre gli indirizzi IP stateful nelle operazioni di riparazione automatica, aggiornamento e ricreazione delle istanze.
- Assegna un indirizzo IP statico a un'istanza esistente in un gruppo di istanze gestite. Per gli IP esterni statici, questa operazione richiede l'aggiornamento dell'istanza, mentre per gli IP interni statici richiede la sua ricreazione.
- Aggiorna la regola di eliminazione per un indirizzo IP statico già assegnato. Questa operazione può essere eseguita senza interrompere l'istanza in esecuzione.
--stateful-internal-ip
per impostare un indirizzo IP interno statico di una determinata interfaccia di rete.--stateful-external-ip
per impostare un indirizzo IP esterno statico di una determinata interfaccia di rete.- INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite.
- INSTANCE_NAME: il nome dell'istanza per la quale configurare gli indirizzi IP stateful.
- NI_NAME: (facoltativo) Nome dell'interfaccia di rete. Se non viene fornita, per impostazione predefinita viene assunta l'interfaccia di rete principale denominata
nic0
. Se hai più interfacce di rete, puoi specificare questo flag per ogni IP in ogni interfaccia di rete. - ADDRESS: indirizzo IP statico da assegnare all'istanza in uno
tra i seguenti formati:
- Indirizzo. URL di una prenotazione di un indirizzo IP statico, ad esempio:
"projects/example-project/regions/us-east1/addresses/example-ip-name"
. - Letterale. Ad esempio:
"130.211.181.55"
.- Se l'indirizzo IP fornito non è ancora prenotato, il MIG crea automaticamente una prenotazione dell'indirizzo IP corrispondente.
- Se l'indirizzo IP fornito è riservato, il gruppo di istanze gestite assegna la prenotazione all'istanza.
- Questo sottoflag è facoltativo se l'indirizzo è già definito nella configurazione per istanze dell'istanza. In caso contrario, è obbligatorio.
- Se omesso, l'indirizzo configurato rimane invariato.
- Indirizzo. URL di una prenotazione di un indirizzo IP statico, ad esempio:
DELETE_RULE: (facoltativo) Stabilisce cosa deve succedere a una risorsa Indirizzo statica associata quando un'istanza VM viene eliminata definitivamente. Le opzioni disponibili sono le seguenti:
never
: (valore predefinito). Non eliminare mai l'indirizzo IP statico. Al contrario, scollega l'indirizzo all'eliminazione dell'istanza e mantieni l'indirizzo riservato.on-permanent-instance-deletion
: elimina la prenotazione dell'indirizzo IP statico quando un'istanza viene eliminata definitivamente dal gruppo di istanze, ad esempio quando elimini un'istanza manualmente o diminuisci le dimensioni del gruppo.- Se omesso, il valore predefinito viene impostato per una nuova configurazione IP con stato; il valore rimane invariato in una configurazione esistente.
Indipendentemente dal valore della regola di eliminazione, il gruppo conserva sempre gli indirizzi IP stateful nelle operazioni di riparazione automatica, aggiornamento e ricreazione delle istanze.
--update-instance
: (facoltativo) Default.) Applica immediatamente le modifiche all'istanza. Se utilizzi il flag--no-update-instance
, le modifiche rimangono non applicate e verranno applicate quando ricrei o applichi l'aggiornamento all'istanza in un secondo momento.MINIMAL_ACTION: (facoltativo) Esegui almeno l'azione specificata quando applichi l'aggiornamento della configurazione per istanza all'istanza. Deve essere utilizzato insieme al flag
--update-instance
. Il valore deve essere uno dei seguenti:none
: nessuna azione.refresh
: applica gli aggiornamenti che è possibile applicare senza interrompere l'istanza.restart
: arresta l'istanza e riavviala.replace
: ricrea l'istanza.
- Aggiorna la configurazione per istanza per l'istanza
file-server
:- Aggiunge la configurazione dell'indirizzo IP esterno stateful, che rimanda alla prenotazione dell'indirizzo
file-server-ip
. - Mantiene invariata la configurazione del disco dati stateful esistente.
- Aggiunge la configurazione dell'indirizzo IP esterno stateful, che rimanda alla prenotazione dell'indirizzo
- Applica immediatamente l'aggiornamento della configurazione per istanza all'istanza
file-server
perché è incluso il flag--update-instance
: aggiorna l'istanza e assegna l'indirizzo IP esterno statico dalla prenotazionefile-server-ip
. - PROJECT_ID: l'ID progetto per la richiesta.
- NAME: il nome del gruppo di istanze gestite.
- REGION: per i gruppi di istanze gestite a livello di regione, la
regione in cui si trova il gruppo. Per i gruppi di istanze gestite a livello di zona, sostituisci
regions/REGION
conzones/ZONE
e specifica la zona in cui si trova il gruppo di istanze gestite. - INSTANCE_NAME: (obbligatorio). Il nome dell'istanza per la quale configurare gli IP stateful.
- NI_NAME: (obbligatorio). Nome dell'interfaccia di rete. L'interfaccia di rete principale si chiama
nic0
. Se hai più interfacce di rete, puoi specificare più NI_NAMES. - ADDRESS: (facoltativo) Indirizzo IP statico da assegnare all'istanza nel formato di un URL di una prenotazione di indirizzo IP statico, ad esempio
"projects/example-project/regions/us-east1/addresses/example-ip-name"
. Quando assegni un indirizzo IP statico, devi e puoi impostare un solo campo alla volta, indirizzo o letterale. - LITERAL: (facoltativo) Indirizzo IP statico da assegnare all'istanza nel formato letterale. Ad esempio:
"130.211.181.55"
. Devi e puoi impostare un solo campo alla volta, indirizzo o letterale, quando assegni un indirizzo IP statico.- Se l'indirizzo IP letterale fornito non è ancora prenotato, il MIG crea automaticamente una prenotazione dell'indirizzo IP corrispondente.
- Se l'indirizzo IP letterale fornito è riservato, il gruppo di istanze gestite assegna la prenotazione all'istanza.
DELETE_RULE: (facoltativo) Stabilisce cosa deve succedere a una risorsa Indirizzo statica associata quando un'istanza VM viene eliminata definitivamente. Le opzioni disponibili sono le seguenti:
NEVER
: (valore predefinito). Non eliminare mai l'indirizzo IP statico. Al contrario, scollega l'indirizzo all'eliminazione dell'istanza e mantieni l'indirizzo riservato.ON_PERMANENT_INSTANCE_DELETION
: elimina la prenotazione dell'indirizzo IP statico quando un'istanza viene eliminata definitivamente dal gruppo di istanze, ad esempio quando elimini un'istanza manualmente o diminuisci le dimensioni del gruppo.- Se omesso, il valore predefinito viene impostato per una nuova configurazione IP con stato; il valore rimane invariato in una configurazione esistente.
Indipendentemente dal valore della regola di eliminazione, il gruppo conserva sempre gli indirizzi IP stateful nelle operazioni di riparazione automatica, aggiornamento e ricreazione delle istanze.
FINGERPRINT: (facoltativo) L'impronta per la configurazione specificata, se esistente. Utilizzato per il blocco ottimistico. L'operazione non va a buon fine se l'impronta è diversa da quella fornita, in quanto indica che la configurazione per istanza è stata modificata dall'ultima lettura. Per visualizzare l'impronta più recente, consulta l'output del metodo
listPerInstanceConfigs
per un gruppo di istanze gestite a livello di regione o a livello di zona. Sefingerprint
viene omesso, l'operazione procede senza il confronto delle impronte.- Aggiunge la configurazione dell'indirizzo IP esterno stateful, che rimanda alla prenotazione dell'indirizzo
file-server-ip
. - Mantiene invariata la configurazione del disco dati stateful esistente.
- Ristruttura l'app in modo che non si basi più su indirizzi IP statici.
- Hai configurato l'IP come stateful per errore e vuoi ripristinarlo.
- L'indirizzo IP rimane attivo nell'istanza, ma non è più stateful.
- Quando ricrei o aggiorni l'istanza o quando viene eseguita la riparazione automatica dell'istanza, il MIG annulla l'assegnazione della prenotazione dell'indirizzo IP statico associato e assegna automaticamente un indirizzo temporaneo.
- Dopo essere stato annullato, l'indirizzo IP statico rimane riservato.
- In che modo la rimozione della configurazione IP stateful dalle configurazioni per istanza influisce sullo stato conservato.
- Applicazione degli aggiornamenti delle configurazioni per istanza.
- INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite.
- INSTANCE_NAME: (obbligatorio) Il nome dell'istanza per la quale rimuovere la configurazione IP stateful.
- NI_NAME: (obbligatorio) Nome dell'interfaccia di rete. L'interfaccia di rete principale si chiama
nic0
. Se hai più interfacce di rete, puoi specificare più NI_NAMES. --update-instance
: (facoltativo) Default.) Applica immediatamente le modifiche all'istanza. Se utilizzi il flag--no-update-instance
, le modifiche rimangono non applicate e verranno applicate quando ricrei o applichi l'aggiornamento all'istanza in un secondo momento.MINIMAL_ACTION: (facoltativo) Esegui almeno l'azione specificata quando applichi l'aggiornamento della configurazione per istanza all'istanza. Questo flag può essere utilizzato solo insieme al flag
--update-instance
. Il valore deve essere uno dei seguenti:none
: nessuna azione.refresh
: applica gli aggiornamenti che è possibile applicare senza arrestare l'istanza.restart
: arresta l'istanza e riavviala.replace
: ricrea l'istanza.
Se omesso, viene utilizzata l'azione meno invasiva richiesta dall'aggiornamento.
- Rimuove la configurazione stateful per l'indirizzo IP esterno all'interno
dell'interfaccia di rete
nic0
dalla configurazione per istanza pernode-1
. - L'aggiornamento della configurazione per istanza viene applicato immediatamente all'istanza VM
node-1
perché è incluso il flag--update-instance
. L'istanza VM non viene interrotta e continua a essere pubblicata dallo stesso IP, che non è più stateful. Il gruppo di istanze gestite rimuove il riferimento alla prenotazione di un indirizzo IP statico dal filepreservedStateFromConfig
dell'istanza gestita e tratta l'indirizzo IP esterno come temporaneo. Il gruppo di istanze gestite assegna automaticamente un indirizzo IP esterno agli eventi di ricreazione, aggiornamento o riparazione automatica delle istanze successive. - Dopo essere stato disassociato, l'IP statico originale rimane riservato. Puoi rilasciare l'IP se non ti serve più.
- PROJECT_ID: l'ID progetto per la richiesta.
- NAME: il nome del gruppo di istanze gestite.
- REGION: per i gruppi di istanze gestite a livello di regione, la
regione in cui si trova il gruppo. Per i gruppi di istanze gestite a livello di zona, sostituisci
regions/REGION
conzones/ZONE
e specifica la zona in cui si trova il gruppo di istanze gestite. - INSTANCE_NAME: (obbligatorio). Il nome dell'istanza per la quale rimuovere la configurazione IP stateful.
- NI_NAME: (obbligatorio). Nome dell'interfaccia di rete. L'interfaccia di rete principale si chiama
nic0
. Se hai più interfacce di rete, puoi specificare più NI_NAMES. - FINGERPRINT: (facoltativo) L'impronta per la configurazione specificata, se esistente. Utilizzato per il blocco ottimistico. L'operazione non va a buon fine se l'impronta è diversa da quella fornita, in quanto indica che la configurazione per istanza è stata modificata dall'ultima lettura. Per visualizzare l'impronta più recente, consulta l'output del metodo
listPerInstanceConfigs
per un gruppo di istanze gestite a livello di regione o a livello di zona. Sefingerprint
viene omesso, l'operazione procede senza il confronto delle impronte. - Per rimuovere solo gli indirizzi IP stateful, consulta Dichiarare inattivi gli indirizzi IP precedentemente stateful.
- Per rimuovere tutta la configurazione stateful da un criterio stateful, consulta Rimuovere un criterio stateful.
- Per rimuovere solo gli indirizzi IP stateful, consulta Disassociazione di un indirizzo IP statico da una VM esistente in un'operazione di migrazione di rete.
- Per rimuovere tutta la configurazione stateful da una configurazione per istanza, consulta Rimuovere la configurazione stateful per una VM specifica.
- Per rilasciare automaticamente le prenotazioni degli indirizzi IP statici al momento dell'eliminazione definitiva dell'istanza, imposta il parametro
autoDelete
suON_PERMANENT_INSTANCE_DELETION
. - Per rilasciare manualmente le prenotazioni degli indirizzi IP statici, imposta il parametro
autoDelete
suNEVER
. Per eliminare le prenotazioni di indirizzi IP statici inutilizzati, ad esempio per evitare addebiti non necessari, consulta i seguenti documenti: - Scopri di più su come applicare, visualizzare e rimuovere la configurazione stateful.
- Ottieni informazioni su un gruppo di istanze gestite specifico e sulle relative istanze gestite, inclusi lo stato e le proprietà delle VM.
- Scopri di più sull'utilizzo delle istanze gestite.
Terraform
Per utilizzare gli esempi di Terraform in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Per ulteriori informazioni, consulta Set up authentication for a local development environment.
REST
Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Per saperne di più, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.
Limitazioni
Un gruppo di istanze gestite con indirizzi IP stateful presenta le seguenti limitazioni:
Un gruppo di istanze gestite con configurazione stateful, ovvero un gruppo di istanze gestite stateful, presenta le seguenti limitazioni:
Prezzi
Ti verranno addebitati gli indirizzi IP esterni in base ai prezzi della rete.
Quando utilizzare indirizzi IP con stato
La conservazione degli indirizzi IP delle istanze è utile nei seguenti scenari:
Configurazione di indirizzi IP stateful per tutte le VM di un gruppo
La configurazione di indirizzi IP stateful per tutte le VM in un gruppo di istanze gestite è utile nei seguenti scenari:
Per mantenere invariati gli indirizzi IP interni o esterni per le istanze VM esistenti e future nel gruppo, configurali nel criterio stateful.
Quando aggiungi la configurazione degli indirizzi IP stateful al criterio stateful del gruppo, il MIG applica la configurazione nel seguente modo:
Per prenotare un indirizzo IP statico, il gruppo di istanze gestite crea una risorsa Address.
Configurazione degli indirizzi IP stateful durante la creazione del gruppo di istanze gestite
Utilizza la console Google Cloud, gcloud CLI, Terraform o REST.
Console
gcloud
Quando crei un gruppo di istanze gestite, per specificare quali indirizzi IP nelle interfacce di rete del modello di istanza devono essere stateful, utilizza uno o più dei seguenti flag con il comando
gcloud compute instance-groups managed create
:gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --template INSTANCE_TEMPLATE \ --size SIZE \ --instance-redistribution-type NONE \ --stateful-internal-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE] \ --stateful-external-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE]
Sostituisci quanto segue:
Esempio
Devi creare un gruppo regionale di istanze VM con indirizzi IP interni statici per le reti predefinite e personalizzate e indirizzi IP esterni statici solo per la rete predefinita. Vuoi che gli indirizzi vengano assegnati automaticamente, ma devi conservarli tramite la riparazione automatica, gli aggiornamenti e gli eventi di ricreazione delle istanze. Archivi la configurazione dell'istanza in un modello di istanza denominato
node-template
.Per creare il gruppo, esegui il seguente comando:
gcloud compute instance-groups managed create example-group \ --region us-east1 \ --template node-template \ --base-instance-name node \ --instance-redistribution-type NONE \ --size 3 \ --stateful-internal-ip interface-name=nic0,auto-delete=on-permanent-instance-deletion --stateful-internal-ip interface-name=nic1,auto-delete=on-permanent-instance-deletion --stateful-external-ip enabled,auto-delete=on-permanent-instance-deletion
Gli IP interni all'interno delle interfacce di rete
nic0
enic1
e l'IP esterno all'interno dell'interfaccia di retenic0
sono configurati come stateful per tutte le istanze del gruppo. Il gruppo riserva automaticamente indirizzi IP interni ed esterni statici per ogni istanza. Poiché il flagauto-delete
è impostato suon-permanent-instance-deletion
, il gruppo eliminerà automaticamente le prenotazioni degli indirizzi IP statici quando elimini le istanze associate o l'intero gruppo.Per verificare che gli indirizzi IP interni all'interno delle interfacce di rete
nic0
enic1
e l'indirizzo IP esterno all'interno dell'interfaccia di retenic0
siano configurati come stateful, esegui il seguente comando:gcloud compute instance-groups managed describe example-group \ --zone us-east1-c
L'output è simile al seguente:
baseInstanceName: node ... name: example-group ... statefulPolicy: preservedState: internalIPs: nic0: autoDelete: ON_PERMANENT_INSTANCE_DELETION nic1: autoDelete: ON_PERMANENT_INSTANCE_DELETION externalIPs: nic0: autoDelete: ON_PERMANENT_INSTANCE_DELETION ...
Puoi vedere che il criterio stateful del gruppo dichiara gli IP interni all'interno delle interfacce di rete
nic0
enic1
e gli IP esterni all'interno dell'interfaccia di retenic0
come stateful con la regola per eliminare le prenotazioni di IP statici all'eliminazione permanente delle istanze.Terraform
Se non hai ancora creato un modello di istanza che specifichi il tipo di macchina, l'immagine del disco di avvio, la rete e altre proprietà della VM che vuoi per ogni VM nel tuo gruppo di istanze gestite, crea un modello di istanza.
Quando crei un gruppo di istanze gestite, per specificare quali indirizzi IP all'interno delle interfacce di rete del modello di istanza devono essere stateful, utilizza uno o più dei seguenti blocchi:
Il seguente esempio configura gli indirizzi IP stateful durante la creazione di un gruppo di istanze gestite regionale. Per ulteriori informazioni sulla risorsa utilizzata nel sample, consulta la
google_compute_region_instance_group_manager
risorsa.Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
REST
Quando crei un gruppo di istanze gestite, per specificare quali indirizzi IP all'interno delle interfacce di rete del modello di istanza devono essere stateful, includili nel campo
statefulPolicy
nel corpo della richiesta del metodoinstanceGroupManagers.insert
oregionInstanceGroupManagers.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/instanceGroupManagers { "name": "INSTANCE_GROUP_NAME", "versions": [ { "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE" } ], "targetSize": SIZE, "statefulPolicy": { "preservedState": { "internalIPs": { "NI_NAME": {"autoDelete": "DELETE_RULE" } }, "externalIPs": { "NI_NAME": {"autoDelete": "DELETE_RULE" } } } }, "updatePolicy": { "instanceRedistributionType": "NONE" } }
Sostituisci quanto segue:
Esempio
Devi creare un gruppo regionale di istanze VM con indirizzi IP interni statici per le reti predefinite e personalizzate e indirizzi IP esterni statici solo per la rete predefinita. Vuoi che gli indirizzi vengano assegnati automaticamente, ma devi conservarli tramite la riparazione automatica, gli aggiornamenti e gli eventi di ricreazione delle istanze. Archivi la configurazione dell'istanza in un modello di istanza denominato
node-template
.Per creare il gruppo, utilizza il metodo
regionInstanceGroupManagers.insert
:POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers { "name": "example-group", "baseInstanceName": "node", "versions": [ { "instanceTemplate": "global/instanceTemplates/node-template" } ], "targetSize": 3, "statefulPolicy": { "preservedState": { "internalIPs": { "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }, "nic1": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" } } "externalIPs": { "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" } } } }, "updatePolicy": { "instanceRedistributionType": "NONE" } }
Gli IP interni all'interno delle interfacce di rete
nic0
enic1
e gli IP esterni all'interno dell'interfaccia di retenic0
sono configurati come stateful per tutte le istanze del gruppo. Il gruppo riserva automaticamente indirizzi IP interni ed esterni statici per ogni istanza. Poiché il campoauto-delete
è impostato suON_PERMANENT_INSTANCE_DELETION
, il gruppo eliminerà automaticamente le prenotazioni degli indirizzi IP statici quando elimini le istanze associate o l'intero gruppo.Utilizza il metodo
regionInstanceGroupManagers.get
per verificare che gli IP interni all'interno delle interfacce di retenic0
enic1
e gli IP esterni all'interno dell'interfaccia di retenic0
siano configurati nel criterio stateful della nuova risorsaregionInstanceGroupManagers
:GET https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-group
La risposta contiene il criterio con stato configurato:
{ "name": "example-group", "baseInstanceName": "node", ... "statefulPolicy": { "preservedState": { "internalIPs": { "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }, "nic1": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" } } "externalIPs": { "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" } } } } ... }
Puoi vedere che il criterio stateful del gruppo dichiara come stateful gli IP interni all'interno delle interfacce di rete
nic0
enic1
e gli IP esterni all'interno dell'interfaccia di retenic0
con la regola per eliminare le prenotazioni degli indirizzi IP statici associati all'eliminazione permanente dell'istanza.Impostazione e aggiornamento della configurazione stateful per gli indirizzi IP nel gruppo di istanze gestite esistente
Se esegui un workload su un gruppo di istanze gestite stateless (un gruppo di istanze gestite senza configurazione stateful) e il workload richiede indirizzi IP statici, puoi configurare gli indirizzi IP già assegnati alle istanze VM gestite in modo che diventino stateful. In questo modo, gli indirizzi IP delle VM esistenti vengono conservati negli eventi di riparazione automatica, aggiornamento e ricreazione delle istanze. Se vuoi, puoi mantenere le prenotazioni degli indirizzi IP statici dopo l'eliminazione delle istanze.
Configurando un criterio stateful per gli indirizzi IP in un MIG esistente, puoi svolgere quanto segue:
Il gruppo di istanze gestite applica la configurazione aggiornata nel criterio stateful automaticamente e in modo asincrono a tutte le istanze. Gli aggiornamenti alle configurazioni degli indirizzi IP in un criterio stateful non interrompono le istanze VM in esecuzione. Per scoprire di più, leggi l'articolo sull'applicazione degli aggiornamenti delle norme con stato.
Console
gcloud
Per specificare quali indirizzi IP devono essere stateful o per aggiornare la configurazione IP stateful per un MIG esistente, utilizza uno o più flag
--stateful-internal-ip
o--stateful-external-ip
con il comandogcloud compute instance-groups managed update
.gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \ --stateful-internal-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE] \ --stateful-external-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE]
Sostituisci quanto segue:
Se un indirizzo IP specificato è già configurato nel criterio stateful per una determinata interfaccia di rete, il comando aggiorna la configurazione.
Esempio
Devi esporre un file server in esecuzione su un'istanza MIG stateful denominata
example-fs-group
agli utenti esterni tramite indirizzi IP esterni statici. Le istanze nel gruppo hanno indirizzi IP esterni temporanei. Devi assicurarti che gli indirizzi IP vengano conservati nell'autocorrezione e negli aggiornamenti delle istanze in modo che gli utenti esterni abbiano accesso continuo ai server tramite gli indirizzi IP pubblicati. Devi anche mantenere riservati gli indirizzi IP per la continuità in caso di eliminazione involontaria del gruppo.Aggiorna il gruppo di istanze gestite per definire gli indirizzi IP esterni come stateful utilizzando il seguente comando:
gcloud compute instance-groups managed update example-fs-group \ --stateful-external-ip enabled
Di conseguenza, il gruppo promuove in modo asincrono gli indirizzi IP esterni temporanei all'interno dell'interfaccia di rete
nic0
in indirizzi IP statici per tutte le istanze gestite.Gli indirizzi IP esterni vengono ora conservati negli eventi di riparazione automatica, aggiornamento e ricreazione delle istanze. Le prenotazioni degli indirizzi IP statici associati non vengono assegnate e vengono conservate all'eliminazione dell'istanza perché la regola
auto-delete
non specificata è impostata sunever
per impostazione predefinita.Puoi verificare che l'indirizzo IP esterno stateful sia configurato nel policy stateful eseguendo il comando
gcloud compute instance-groups managed describe example-fs-group
.REST
Per specificare quali indirizzi IP devono essere stateful o per aggiornare la configurazione IP stateful per un gruppo di istanze gestite esistente, utilizza il metodo
instanceGroupManagers.patch
oregionInstanceGroupManagers.patch
:PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME { "statefulPolicy": { "preservedState": { "internalIPs": { "NI_NAME": {"autoDelete": "DELETE_RULE" } }, "externalIPs": { "NI_NAME": {"autoDelete": "DELETE_RULE" } } } } }
Sostituisci quanto segue:
Se un indirizzo IP specificato è già configurato nel criterio con stato, il metodo applica una patch alla configurazione.
Esempio
Devi esporre un file server in esecuzione su un'istanza MIG stateful denominata
example-fs-group
agli utenti esterni tramite indirizzi IP esterni statici. Le istanze nel gruppo hanno indirizzi IP esterni temporanei. Devi assicurarti che gli indirizzi IP vengano conservati nell'autocorrezione e negli aggiornamenti delle istanze in modo che gli utenti esterni abbiano accesso continuo ai server tramite l'interfaccia di rete pubblicata. Inoltre, devi mantenere gli indirizzi IP riservati per la continuità in caso di eliminazione involontaria del gruppo.Esegui la patch del gruppo di istanze gestite per definire gli indirizzi IP esterni come stateful:
PATCH https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-fs-group { "statefulPolicy": { "preservedState": { "externalIPs": { "nic0": {"autoDelete": "NEVER" } } } } }
Di conseguenza, il gruppo promuove in modo asincrono gli indirizzi IP esterni temporanei all'interno dell'interfaccia di rete
nic0
in indirizzi IP statici per tutte le istanze gestite.Gli indirizzi IP esterni vengono ora conservati negli eventi di riparazione automatica, aggiornamento e ricreazione delle istanze. Le prenotazioni degli indirizzi IP statici associati non verranno assegnate e verranno conservate all'eliminazione dell'istanza perché la regola
autoDelete
è impostata suNEVER
.Verifica che l'indirizzo IP esterno sia configurato nel criterio stateful visualizzando la risorsa
regionInstanceGroupManagers
, restituita dal metodoregionInstanceGroupManagers.get
.Dichiarazione di indirizzi IP precedentemente con stato come senza stato
Potresti dover configurare un indirizzo IP stateful in modo che diventi effimero, ad esempio per i seguenti motivi:
Puoi rimuovere la configurazione IP stateful dal criterio stateful del gruppo per dichiarare un indirizzo IP all'interno di una determinata interfaccia di rete come effimero per tutte le istanze gestite.
Quando rimuovi la configurazione IP stateful dal criterio stateful, il gruppo di istanze gestite rimuove gli indirizzi IP automaticamente e in modo asincrono dallo stato preservato di tutte le istanze del gruppo. Questa operazione non interrompe le istanze VM in esecuzione. Gli indirizzi IP rimangono attivi nelle istanze, ma non sono più stateful. Quando ricrei o aggiorni le istanze o quando vengono riparate automaticamente, il gruppo di istanze gestite annulla l'assegnazione degli indirizzi IP statici associati e assegna automaticamente indirizzi temporanei. Se non hai più bisogno di mantenere le prenotazioni degli indirizzi IP esterni statici, ora puoi rilasciarli.
Per saperne di più, leggi i seguenti documenti:
Console
gcloud
Per specificare quali indirizzi IP del criterio stateful di un gruppo di istanze gestite devono essere temporanei, utilizza il flag
--remove-stateful-internal-ips
o--remove-stateful-external-ips
con il comandogcloud compute instance-groups managed update
:gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \ --remove-stateful-internal-ips NI_NAME[,NI_NAME,...] \ --remove-stateful-external-ips NI_NAME[,NI_NAME,...]
Sostituisci quanto segue:
Se devi trasformare un indirizzo IP stateful dell'interfaccia di rete primaria predefinita denominata
nic0
in un indirizzo IP temporaneo, puoi anche utilizzare il seguente comando:gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \ --stateful-internal-ip disabled \ --stateful-external-ip disabled
Esempio
La tua applicazione è stata esposta agli utenti tramite gli indirizzi IP esterni statici pubblicati delle istanze VM in un gruppo di istanze gestite denominato
example-group
. Hai ridisegnato l'architettura del servizio implementando un bilanciatore del carico davanti al gruppo di istanze gestite e reindirizzando il traffico alle VM gestite tramite questo bilanciatore. Non devi più gestire gli indirizzi IP esterni statici e vorresti rendere temporanei gli indirizzi IP esterni delle VM.Per rendere effimeri gli indirizzi IP esterni stateful delle VM in un gruppo di istanze gestite, esegui il seguente comando:
gcloud compute instance-groups managed update example-group \ --remove-stateful-external-ips nic0
Il gruppo di istanze gestite rimuove automaticamente e in modo asincrono gli indirizzi IP esterni statici dell'interfaccia di rete
nic0
dal stato preservato di tutte le istanze del gruppo. Gli indirizzi IP esterni rimangono attivi sulle istanze, ma non sono più stateful. Quando ricrei o aggiorni le istanze o quando vengono riparate automaticamente, il gruppo MIG annulla l'assegnazione degli indirizzi IP statici associati e assegna automaticamente indirizzi effimeri. Se non hai più bisogno di mantenere le prenotazioni degli indirizzi IP esterni statici, ora puoi rilasciarli.REST
Per specificare quali indirizzi IP del criterio stateful di un gruppo di istanze gestite devono essere temporanei, rimuovi la configurazione di ciascun IP dal criterio stateful del gruppo di istanze gestite utilizzando il metodo
instanceGroupManagers.patch
oregionInstanceGroupManagers.patch
:PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME { "statefulPolicy": { "preservedState": { "internalIPs": { "NI_NAME": null }, "externalIPs": { "NI_NAME": null } } } }
Sostituisci quanto segue:
Esempio
La tua applicazione è stata esposta agli utenti tramite gli indirizzi IP esterni statici pubblicati delle istanze VM in un gruppo di istanze gestite denominato
example-group
. Hai ristrutturato il servizio implementando un bilanciatore del carico davanti al gruppo MIG e inoltrando il traffico alle VM gestite tramite questo bilanciatore. Non devi più gestire gli indirizzi IP esterni statici e vuoi rendere temporanei gli indirizzi IP esterni delle VM.Per rendere effimeri gli indirizzi IP esterni stateful delle VM in un gruppo di istanze gestite, esegui la patch del gruppo di istanze gestite:
PATCH https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-group { "statefulPolicy": { "preservedState": { "externalIPs": { "nic0": null } } } }
Il gruppo di istanze gestite rimuove automaticamente e in modo asincrono gli indirizzi IP esterni statici dell'interfaccia di rete
nic0
dal stato preservato di tutte le istanze del gruppo. Gli indirizzi IP esterni rimangono attivi sulle istanze, ma non sono più stateful. Quando ricrei o aggiorni le istanze o quando vengono riparate automaticamente, il gruppo MIG annulla l'assegnazione degli indirizzi IP statici associati e assegna automaticamente indirizzi effimeri. Se non hai più bisogno di mantenere le prenotazioni degli indirizzi IP esterni statici, ora puoi rilasciarli.Configurazione degli indirizzi IP stateful singolarmente per le VM in un gruppo di istanze gestite
La configurazione degli indirizzi IP stateful singolarmente per le VM in un gruppo di istanze gestite è utile nei seguenti scenari:
Configurazione degli indirizzi IP statici durante la creazione di una VM in un gruppo di istanze gestite
Puoi prenotare e assegnare indirizzi IP statici a istanze specifiche quando le crei singolarmente in un gruppo di istanze gestite. Questa operazione è utile per eseguire la migrazione di un'applicazione stateful da VM autonome esistenti a un gruppo di istanze gestite stateful in una situazione in cui l'architettura, la configurazione o gli utenti si basano su indirizzi IP statici specifici.
Quando crei manualmente un'istanza in un gruppo di istanze gestite e fornisci un indirizzo IP statico, il gruppo di istanze gestite esegue le seguenti azioni:
gcloud
Per creare un'istanza con un indirizzo IP statico predefinito, utilizza il comando
gcloud compute instance-groups managed create-instance
con uno o più dei seguenti flag:gcloud compute instance-groups managed create-instance INSTANCE_GROUP_NAME \ --instance INSTANCE_NAME \ --stateful-internal-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \ --stateful-external-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE]
Sostituisci quanto segue:
Esempio
Devi aggiungere un'altra istanza VM al cluster del server proxy, in esecuzione su un gruppo di istanze gestite denominato
proxy-cluster
. Hai creato una prenotazione di un indirizzo IP interno staticoproxy-node-03-ip
e devi assegnarla al nuovo nodo. Vuoi mantenere la prenotazione dell'indirizzo IP anche se decidi di eliminare il nodo in futuro.Esegui il comando seguente per creare il nodo:
gcloud compute instance-groups managed create-instance proxy-cluster \ --instance proxy-node-03 \ --stateful-internal-ip address="projects/example-project/regions/us-east1/addresses/proxy-node-03-ip",auto-delete=never
Il comando crea un'istanza denominata
proxy-node-03
, assegna all'istanza l'indirizzo IP interno statico fornito denominatoproxy-node-03-ip
e memorizza la configurazione stateful per l'IP nella corrispondente configurazione per istanza. Poiché il flagauto-delete
è impostato sunever
, l'IP rimane riservato se elimini l'istanza in un secondo momento.Terraform
Per creare una VM con un indirizzo IP statico predefinito, utilizza uno o più dei seguenti blocchi:
L'esempio seguente configura gli indirizzi IP statici durante la creazione di una VM in un gruppo di istanze gestite regionale. Per ulteriori informazioni sulla risorsa utilizzata nel sample, consulta la
google_compute_region_per_instance_config
risorsa. Per un gruppo di istanze gestite a livello di zona, utilizza la risorsagoogle_compute_per_instance_config
.Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
REST
Per creare una o più istanze in un gruppo di istanze gestite, impostare nomi di istanze personalizzati e assegnare indirizzi IP statici predefiniti a queste istanze, utilizza il metodo
instanceGroupManagers.createInstances
oregionInstanceGroupManagers.createInstances
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/createInstances { "instances": [ { "name": "INSTANCE_NAME", "preservedState" : { "internalIPs": { "NI_NAME" : { "ipAddress": { "address": "ADDRESS", "literal": "LITERAL" }, "autoDelete": "DELETE_RULE" }, ... }, "externalIPs": { "NI_NAME" : { "ipAddress": { "address": "ADDRESS", "literal": "LITERAL" }, "autoDelete": "DELETE_RULE" }, ... }, ... } }, ... ] }
Sostituisci quanto segue:
Esempio
Devi aggiungere un'altra istanza VM al cluster del server proxy, in esecuzione su un gruppo di istanze gestite denominato
proxy-cluster
. Hai creato una prenotazione di un indirizzo IP interno staticoproxy-node-03-ip
e devi assegnarla al nuovo nodo. Vuoi mantenere la prenotazione dell'indirizzo IP anche se decidi di eliminare il nodo in futuro.Chiama il metodo
regionInstanceGroupManagers.createInstances
per creare un'istanza aggiuntiva:POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/proxy-cluster/createInstances { "instances": [ { "name": "proxy-node-03", "preservedState" : { "internalIPs": { "nic0" : { "ipAddress": { "address": "projects/example-project/regions/us-east1/addresses/proxy-node-03-ip" }, "autoDelete": "NEVER" } } } } ] }
Il metodo crea un'istanza denominata
proxy-node-03
, assegna all'istanza l'indirizzo IP interno statico fornito denominatoproxy-node-03-ip
e memorizza la configurazione stateful per l'IP nella corrispondente configurazione per istanza. Poiché il campoautoDelete
è impostato suNEVER
, l'IP rimane riservato se elimini l'istanza in un secondo momento.Configurare gli indirizzi IP statici per una VM esistente in un gruppo di istanze gestite
Puoi impostare un indirizzo IP statico predefinito o aggiornare singolarmente la configurazione IP stateful per un'istanza gestita, ad esempio:
Per un'istanza esistente senza un indirizzo IP esterno, per la quale hai configurato un IP stateful esterno, il gruppo di istanze gestite aggiunge la configurazione di accesso all'interfaccia di rete corrispondente con i seguenti valori predefiniti:
"accessConfigs": [ { "kind": "compute#accessConfig", "name": "External Nat", "natIP": "XX.XX.XX.XX", "networkTier": "PREMIUM", "type": "ONE_TO_ONE_NAT" } ]
gcloud
Per configurare un indirizzo IP stateful singolarmente per un'istanza VM in un gruppo di istanze gestite, aggiungi o aggiorna la configurazione dell'IP stateful nella configurazione per istanza associata.
Se non esiste ancora una configurazione per istanza per l'istanza, utilizza il comando
gcloud compute instance-groups managed instance-configs create
con uno o più dei seguenti flag:gcloud compute instance-groups managed instance-configs create INSTANCE_GROUP_NAME \ --instance INSTANCE_NAME \ --stateful-internal-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \ --stateful-external-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \ [--no-update-instance | --update-instance] [--instance-update-minimal-action MINIMAL_ACTION]
Se per l'istanza esiste già una configurazione per istanza, utilizza il comando
gcloud compute instance-groups managed instance-configs update
con uno o più flag--stateful-internal-ip
o--stateful-external-ip
:gcloud compute instance-groups managed instance-configs update INSTANCE_GROUP_NAME \ --instance INSTANCE_NAME \ --stateful-internal-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \ --stateful-external-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \ [--no-update-instance | --update-instance] [--instance-update-minimal-action MINIMAL_ACTION]
Sostituisci quanto segue:
Se omesso, viene utilizzata l'azione meno invasiva richiesta dall'aggiornamento.
Esempio
Hai un'istanza del file server denominata
file-server
, che è una singola istanza in un gruppo di istanze gestite stateful denominatofs-group
. Il gruppo ha una configurazione per istanza corrispondente, in cui è configurato un disco dati stateful. Il file server è stato accessibile solo internamente, ma ora hai utenti che devono accedervi esternamente tramite un indirizzo IP statico. Hai prenotato l'IP esterno statico creando una prenotazione dell'indirizzofile-server-ip
. Ora devi assegnare questo indirizzo IP all'istanza del file server.Esegui il comando seguente per configurare l'IP esterno stateful per l'istanza del server file:
gcloud compute instance-groups managed instance-configs update fs-group \ --instance file-server \ --stateful-external-ip interface-name=nic0,address="projects/example-project/regions/us-east1/addresses/file-server-ip",auto-delete=never \ --update-instance
Il comando esegue le seguenti operazioni:
REST
Per configurare gli IP con stato singolarmente per le istanze VM in un gruppo di istanze gestite, aggiungi o aggiornate la configurazione degli IP con stato nelle configurazioni per istanza associate.
Se non esistono ancora configurazioni per istanza per le istanze in questione, utilizza il metodo
instanceGroupManagers.updatePerInstanceConfigs
o il metodoregionInstanceGroupManagers.updatePerInstanceConfigs
con configurazione stateful per uno o più indirizzi IP:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/updatePerInstanceConfigs { "perInstanceConfigs": [ { "name": "INSTANCE_NAME", "preservedState" : { "internalIPs": { "NI_NAME" : { "ipAddress": { "address": "ADDRESS", "literal": "LITERAL" }, "autoDelete": "DELETE_RULE" }, ... }, "externalIPs": { "NI_NAME" : { "ipAddress": { "address": "ADDRESS", "literal": "LITERAL" }, "autoDelete": "DELETE_RULE" }, ... }, ... }, "fingerprint: "FINGERPRINT" }, ... ] }
Se esistono già configurazioni per istanza per le istanze in questione, utilizza il metodo
instanceGroupManagers.patchPerInstanceConfigs
o metodoregionInstanceGroupManagers.patchPerInstanceConfigs
con configurazione stateful per uno o più indirizzi IP:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/patchPerInstanceConfigs { "perInstanceConfigs": [ { "name": "INSTANCE_NAME", "preservedState" : { "internalIPs": { "NI_NAME" : { "ipAddress": { "address": "ADDRESS", "literal": "LITERAL" }, "autoDelete": "DELETE_RULE" }, ... }, "externalIPs": { "NI_NAME" : { "ipAddress": { "address": "ADDRESS", "literal": "LITERAL" }, "autoDelete": "DELETE_RULE" }, ... }, ... }, "fingerprint: "FINGERPRINT" }, ... ] }
Sostituisci quanto segue:
I metodi
updatePerInstanceConfigs
epatchPerInstanceConfigs
aggiornano le configurazioni per istanza specificate, ma non applicano gli aggiornamenti della configurazione alle istanze gestite associate. Le modifiche vengono applicate a un'istanza quando al gruppo di istanze gestite viene chiesto di ricrearla o aggiornarla. Puoi applicare l'aggiornamento manualmente per applicare le modifiche a un'istanza.Esempio
Hai un'istanza del file server denominata
file-server
, che è una singola istanza in un gruppo di istanze gestite stateful denominatofs-group
. Il gruppo ha una configurazione per istanza corrispondente, in cui è configurato un disco dati stateful. Il file server era accessibile solo internamente, ma ora hai utenti che devono accedervi esternamente tramite un indirizzo IP statico. Hai prenotato l'IP esterno statico creando una prenotazione dell'indirizzofile-server-ip
. Ora devi assegnare questo indirizzo IP all'istanza del file server.Per aggiornare la configurazione per istanza di
file-server
con il nuovo IP esterno stateful, chiama il metodopatchPerInstanceConfigs
:POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/fs-group/patchPerInstanceConfigs { "perInstanceConfigs": [ { "name": "file-server", "preservedState" : { "externalIPs": { "nic0" : { "ipAddress": { "address": "projects/example-project/regions/us-east1/addresses/file-server-ip" }, "autoDelete": "NEVER" } } } } ] }
Il metodo applica patch alla configurazione per istanza per l'istanza
file-server
:L'aggiornamento della configurazione non è ancora stato applicato all'istanza VM
file-server
. Il gruppo di istanze gestite applicherà l'aggiornamento della configurazione quando ricrei o applichi l'aggiornamento all'istanza in un secondo momento.Per applicare l'aggiornamento della configurazione per istanza all'istanza VM
file-server
, chiama il metodoregionInstanceGroupManagers.applyUpdatesToInstances
per l'istanza:POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/gs-group/applyUpdatesToInstances { "instances": ["/zones/us-east1-b/instances/file-server"] }
Il metodo assegna all'istanza gestita l'indirizzo IP esterno statico configurato dalla prenotazione
file-server-ip
. Il metodo aggiorna l'istanzafile-server
per assegnare un indirizzo IP esterno.Poiché
autoDelete
è impostato suNEVER
nella configurazione IP stateful, l'IP rimarrà riservato se elimini l'istanza in un secondo momento.Disassociazione degli indirizzi IP statici da una VM esistente in un gruppo di istanze gestite
Potresti dover disaccoppiare un indirizzo IP statico da una VM esistente, rendendo l'interfaccia di rete effimera per la VM. Questa opzione è utile nei seguenti scenari:
Puoi disaccoppiare un indirizzo IP statico da una VM esistente nel gruppo di istanze gestite e rendere l'indirizzo IP temporaneo per una singola VM rimuovendo la configurazione stateful dell'IP dalla configurazione per istanza associata o eliminando l'intera configurazione per istanza se non contiene altri stati. L'applicazione della modifica ha i seguenti effetti:
La rimozione di una configurazione IP stateful da una configurazione per istanza non interrompe le istanze VM in esecuzione, a meno che tu non scelga esplicitamente di farlo.
Per saperne di più, consulta i seguenti documenti:
gcloud
Per rimuovere una configurazione IP stateful dalla configurazione per istanza associata, utilizza il comando
gcloud compute instance-groups managed instance-configs update
con i flag--remove-stateful-internal-ips
o--remove-stateful-external-ips
:gcloud compute instance-groups managed instance-configs update INSTANCE_GROUP_NAME \ --instance INSTANCE_NAME \ --remove-stateful-internal-ips NI_NAME[,NI_NAME,...] \ --remove-stateful-external-ips NI_NAME[,NI_NAME,...] [--no-update-instance | --update-instance] \ [--instance-update-minimal-action MINIMAL_ACTION]
Sostituisci quanto segue:
Esempio
La tua applicazione è stata esposta agli utenti tramite indirizzi IP esterni statici pubblicati specifici delle istanze VM in un gruppo di istanze gestite denominato
example-group
. Hai riprogettato il servizio implementando un bilanciatore del carico davanti al MIG e reindirizzando il traffico alle VM gestite tramite questo. Non hai più bisogno di gestire gli indirizzi IP esterni statici e vuoi rendere temporanei gli indirizzi IP esterni delle VM.Per rendere effimeri gli indirizzi IP esterni con stato delle VM in un gruppo di istanze gestite, esegui il seguente comando per ogni istanza, ad esempio per
node-1
:gcloud compute instance-groups managed instance-configs update example-group \ --instance node-1 \ --remove-stateful-external-ips nic0 \ --update-instance
Il comando esegue le seguenti operazioni:
REST
Per rimuovere una configurazione IP stateful dalla configurazione per istanza associata, utilizza il metodo
instanceGroupManagers.patchPerInstanceConfigs
o il metodoregionInstanceGroupManagers.patchPerInstanceConfigs
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/patchPerInstanceConfigs { "perInstanceConfigs": [ { "name": "INSTANCE_NAME", "preservedState" : { "internalIPs": { "NI_NAME" : null }, "externalIPs": { "NI_NAME" : null } }, "fingerprint: "FINGERPRINT" }, ... ] }
Sostituisci quanto segue:
Il metodo
patchPerInstanceConfigs
aggiorna le configurazioni per istanza specificate, ma non applica gli aggiornamenti della configurazione alle istanze gestite associate. Le modifiche vengono applicate a un'istanza quando al gruppo di istanze gestite viene chiesto di ricrearla o aggiornarla. Puoi applicare l'aggiornamento manualmente per applicare le modifiche a un'istanza.Esempio
La tua applicazione è stata esposta agli utenti tramite indirizzi IP esterni statici pubblicati specifici delle istanze VM in un gruppo di istanze gestite chiamato
example-group
. Hai ridisegnato l'architettura del servizio implementando un bilanciatore del carico davanti al gruppo di istanze gestite e reindirizzando il traffico alle VM gestite. Non devi più gestire gli indirizzi IP esterni statici e vuoi rendere temporanei gli indirizzi IP esterni delle VM.Per rendere effimeri gli indirizzi IP esterni stateful delle VM in un MIG, esegui il seguente metodo per ogni istanza, ad esempio per
node-1
, e fornisci il valorenull
alla configurazione stateful dell'interfaccia di rete:POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-group/patchPerInstanceConfigs { "perInstanceConfigs": [ { "name": "node-1", "preservedState" : { "externalIPs": { "nic0" : null } } } ] }
Il metodo rimuove la configurazione dell'indirizzo IP stateful all'interno dell'interfaccia di rete
nic0
dalla configurazione per istanza dinode-1
. L'aggiornamento della configurazione non è ancora stato applicato all'istanza VMnode-1
. Il gruppo di istanze gestite applica l'aggiornamento della configurazione alla successiva ricreazione o aggiornamento dell'istanza.Per applicare l'aggiornamento della configurazione per istanza all'istanza VM
node-1
, esegui il metodoregionInstanceGroupManagers.applyUpdatesToInstances
per l'istanza:POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-group/applyUpdatesToInstances { "instances": ["/zones/us-east1-c/instances/node-1"] }
Il MIG rimuove il riferimento alla prenotazione IP statica dal campo
preservedStateFromConfig
per l'istanzanode-1
e tratta l' indirizzo IP come temporaneo. Il gruppo di istanze gestite assegna automaticamente un indirizzo IP esterno agli eventi di ricreazione, aggiornamento o riparazione automatica delle istanze successive.Dopo essere stato disassociato, l'IP statico originale rimane riservato. Puoi rilasciare l'IP se non ti serve più.
Rimozione della configurazione stateful
Per rimuovere la configurazione da un criterio stateful per tutte le VM in un gruppo di istanze gestite, consulta i seguenti documenti:
Per rimuovere la configurazione da una configurazione per istanza per una VM specifica in un gruppo di istanze gestite, consulta i seguenti documenti:
Eliminazione degli indirizzi IP statici inutilizzati
Quando configuri un indirizzo IP stateful per le istanze gestite in un gruppo, puoi scegliere se rilasciare le prenotazioni degli indirizzi IP statici associati manualmente o automaticamente quando un'istanza viene eliminata definitivamente:
Se hai indicato al gruppo di istanze gestite di non eliminare mai le prenotazioni IP associate, gli indirizzi IP statici rimangono riservati dopo le istanze corrispondenti o il gruppo di istanze gestite non esiste più.
Feedback
Vorremmo conoscere i tuoi casi d'uso, le tue sfide e i tuoi feedback sulle MIG stateful. Puoi condividere il tuo feedback con il nostro team all'indirizzo mig-discuss@google.com.
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-11-23 UTC.
-