Nell'ambiente flessibile di App Engine, puoi specificare una rete su cui eseguire il deployment delle istanze del servizio. Questa pagina mostra come configurare il progetto in modo da utilizzare l'ambiente flessibile di App Engine su una rete VPC condiviso.
Per ulteriori informazioni sulla configurazione di una rete VPC condivisa, consulta Provisioning di una rete VPC condivisa.
Configurazione dell'ambiente flessibile di App Engine con VPC condiviso
Il deployment di istanze dell'ambiente flessibile di App Engine su una rete VPC condiviso prevede tre passaggi:
Se utilizzi Google Cloud CLI, esegui l'aggiornamento alla versione più recente prima di seguire questa guida eseguendo il comando:
gcloud components update
Consentire il traffico alla rete VPC condiviso
Un amministratore del VPC condiviso deve creare una regola del firewall nel progetto host VPC condiviso per consentire il traffico verso l'ambiente App Engine flessibile sulla rete VPC condivisa. La regola del firewall consente il servizio e il traffico di controllo di integrità alle istanze dell'ambiente flessibile.
La regola firewall deve avere le seguenti proprietà:
- Rete: il nome della rete VPC condiviso
- Direzione del traffico: In entrata
- Azione in caso di corrispondenza: Consenti
- Target: Tag di destinazione specificati
- Tag di destinazione:
aef-instance - Filtro di origine: intervalli IP
- Intervalli IP di origine:
35.191.0.0/16,130.211.0.0/22 - Protocolli e porte: Protocolli e porte specificati
- tcp: 8443, 10402
Un amministratore VPC condiviso può creare la regola firewall utilizzando la console Google Cloud o Google Cloud CLI:
Console
Per creare la regola firewall utilizzando la console Google Cloud:
Vai alla pagina di creazione della regola firewall.
Nei campi Nome e Descrizione, fornisci un nome e una descrizione per la regola del firewall.
Compila le proprietà necessarie come specificato sopra.
Fai clic su Crea.
gcloud
Per creare la regola firewall utilizzando Google Cloud CLI, esegui il seguente comando:
gcloud compute firewall-rules create NETWORK_NAME-flex-firewall \ --project HOST_PROJECT_ID \ --network NETWORK_NAME \ --allow tcp:10402,tcp:8443 \ --target-tags aef-instance \ --source-ranges 35.191.0.0/16,130.211.0.0/22 \ --description 'Allows traffic to App Engine flexible environment'
dove:
NETWORK_NAMEè il nome della rete VPC condiviso.HOST_PROJECT_IDè l'ID progetto Google Cloud del progetto host VPC condiviso.
Configurazione delle autorizzazioni
Un amministratore VPC condiviso deve concedere ai seguenti due service account il ruolo Utente di rete Compute per consentire a un progetto di servizio di eseguire il deployment di istanze nell'ambiente flessibile di App Engine sulla rete:
- Agente di servizio API di Google
(
PROJECT_NUM@cloudservices.gserviceaccount.com) - Agente di servizio dell'ambiente flessibile di App Engine
(
service-PROJECT_NUM@gae-api-prod.google.com.iam.gserviceaccount.com)
Console
Per configurare le autorizzazioni utilizzando la console Google Cloud:
Vai alla pagina Impostazioni IAM del progetto di servizio e prendi nota del numero del progetto.
Vai alla pagina IAM del progetto host.
Fai clic su Aggiungi.
Nel campo Nuovi membri, inserisci i seguenti indirizzi email separati da una virgola. Sostituisci
PROJECT_NUMcon il numero del progetto ottenuto nel passaggio 1.PROJECT_NUM@cloudservices.gserviceaccount.comservice-PROJECT_NUM@gae-api-prod.google.com.iam.gserviceaccount.com
Nel menu a discesa Seleziona un ruolo, seleziona Compute Engine > Utente rete Compute.
Fai clic su Salva.
gcloud
Recupera il numero del progetto di servizio in cui è dipiegato l'app App Engine. Esegui il comando seguente, sostituendo
SERVICE_PROJECT_IDcon l'ID progetto del progetto di servizio:export SERVICE_PROJECT_NUM=$(gcloud projects describe SERVICE_PROJECT_ID --format="value(projectNumber)")
Concedi all'agente di servizio delle API Google del progetto di servizio il ruolo
compute.networkUsernel progetto host:gcloud projects add-iam-policy-binding HOST_PROJECT_ID \ --member=serviceAccount:$SERVICE_PROJECT_NUM@cloudservices.gserviceaccount.com \ --role=roles/compute.networkUser
dove
HOST_PROJECT_IDè l'ID progetto Google Cloud del progetto host VPC condiviso.Concedi all'agente di servizio dell'ambiente flessibile di App Engine del progetto di servizio il ruolo
compute.networkUsernel progetto host:gcloud projects add-iam-policy-binding HOST_PROJECT_ID \ --member=serviceAccount:service-$SERVICE_PROJECT_NUM@gae-api-prod.google.com.iam.gserviceaccount.com \ --role=roles/compute.networkUser
Configurazione ed esecuzione del deployment del servizio
Dopo aver configurato la regola firewall e le autorizzazioni appropriate, puoi eseguire il deployment di un nuovo servizio o di un servizio di ambiente flessibile App Engine esistente nella rete VPC condiviso.
Nel file
app.yaml, utilizza il campo network settingsnameper specificare il nome completo della rete VPC condiviso:network: name: projects/HOST_PROJECT_ID/global/networks/NETWORK_NAME
dove
HOST_PROJECT_IDè l'ID progetto Google Cloud del progetto host VPC condiviso.NETWORK_NAMEè il nome della rete VPC condiviso.
Per configurare il servizio in modo che faccia parte di una sottorete denominata
SUBNETWORK_NAME, imposta anche il camposubnetwork_name:network: name: projects/HOST_PROJECT_ID/global/networks/NETWORK_NAME subnetwork_name: SUBNETWORK_NAME
Esegui il deployment del servizio:
gcloud app deploy
Verifica della configurazione
Per verificare che il servizio dell'ambiente flessibile App Engine sia in esecuzione sulla rete VPC condiviso, visualizza la configurazione della versione nella pagina delle versioni di App Engine nella console Google Cloud:
Vai alla pagina Versioni di App Engine.
Nella colonna Config a destra, fai clic su Visualizza per la versione che ti interessa.
Verifica che il nome della rete nella configurazione corrisponda al nome della rete VPC condiviso.