Questo documento spiega come configurare le istanze di macchine virtuali (VM) Dataflow per l'accesso a internet, creare tag di rete e definire regole firewall per la rete associata ai job Dataflow.
Questo documento richiede una conoscenza di base delle reti Google Cloud. Per definire una rete per il job Dataflow, consulta Specifica la rete e la subnet. Per saperne di più su come risolvere i problemi di rete, consulta Risolvere i problemi di rete di Dataflow.
Accesso a internet per Dataflow
Le macchine virtuali (VM) worker di Dataflow devono raggiungere le API e i servizi Google Cloud. A seconda del caso d'uso, le VM potrebbero anche hanno bisogno di accedere a risorse esterne a Google Cloud. Utilizza uno dei seguenti metodi per configurare l'accesso a internet per Dataflow:
Configura le VM worker con un indirizzo IP esterno in modo che soddisfino i requisiti di accesso a internet.
Configura Accesso privato Google. Con l'accesso privato Google, le VM che hanno solo indirizzi IP interni possono per accedere agli indirizzi IP di Google Cloud e dei servizi.
Configura un indirizzo IP dell'endpoint Private Service Connect per accedere alle API e ai servizi Google Cloud.
Configura una soluzione NAT, ad esempio Cloud NAT. Questa opzione è utile per l'esecuzione di job che accedono API e servizi esterni a Google Cloud che richiedono l'accesso a internet. Ad esempio, i job dell'SDK Python potrebbero richiedere l'accesso al Python Package Index (PyPI) per scaricare le dipendenze delle pipeline. In questo caso, devi configurare le VM worker con indirizzi IP esterni o utilizzare Cloud NAT. Puoi anche fornire le dipendenze della pipeline Python durante l'invio del job. Ad esempio, puoi utilizzare container personalizzati per fornire le dipendenze della pipeline Python, eliminando la necessità di accedere a PyPI in fase di runtime.
Per ulteriori informazioni, vedi Gestione delle dipendenze della pipeline Python nella documentazione di Apache Beam.
Disattivare l'indirizzo IP esterno
Per impostazione predefinita, il servizio Dataflow assegna ai worker sia esterni gli indirizzi IP interni. Quando disattivi gli indirizzi IP esterni, Dataflow una pipeline può accedere alle risorse solo nelle seguenti posizioni:
- Un'altra istanza nella stessa rete VPC
- Una rete VPC condivisa
- Una rete con il peering di rete VPC abilitato
Senza indirizzi IP esterni, puoi comunque eseguire attività amministrative e e monitorare le attività. Puoi accedere ai tuoi worker utilizzando SSH tramite le opzioni elencate nell'elenco precedente. Tuttavia, la pipeline non può accedere a internet e gli host internet non possono accedere ai tuoi worker Dataflow.
Il mancato utilizzo di indirizzi IP esterni contribuisce a proteggere meglio il trattamento dati dell'infrastruttura. Inoltre, riduci anche il numero di indirizzi IP esterni che utilizzi per il tuo Google Cloud quota per il progetto.
Se disattivi gli indirizzi IP esterni, i job Dataflow non possono accedere alle API e ai servizi esterni a Google Cloud che richiedono l'accesso a internet.
Per informazioni sulla configurazione dell'accesso a internet per i job con indirizzi IP interni, leggi la sezione precedente.
Per disattivare gli indirizzi IP esterni, procedi nel seguente modo:
Java
- Abilita l'accesso privato Google per la tua rete o subnet.
- Nei parametri del job Dataflow, specifica
--usePublicIps=false
e--network=NETWORK-NAME
o--subnetwork=SUBNETWORK-NAME
.A seconda della tua scelta, sostituisci una delle seguenti opzioni:
- NETWORK-NAME: il nome della tua rete Compute Engine
- SUBNETWORK-NAME: il nome della subnet Compute Engine
Python
- Per eseguire il commit di tutte le dipendenze dei pacchetti Python, segui le istruzioni sulle dipendenze della pipeline di Apache Beam.
- Abilita l'accesso privato Google per la tua rete o subnet.
- Nei parametri del tuo job Dataflow, specifica
--no_use_public_ips
e--network=NETWORK
o--subnetwork=SUBNETWORK
. - NETWORK-NAME: il nome della tua rete Compute Engine
- SUBNETWORK-NAME: il nome della sottorete Compute Engine
A seconda della tua scelta, sostituisci una delle seguenti opzioni:
Vai
- Abilita l'accesso privato Google per il tuo una rete o una subnet.
- Nei parametri del job Dataflow, specifica
--no_use_public_ips
e--network=NETWORK
o--subnetwork=SUBNETWORK
. - NETWORK-NAME: il nome della tua rete Compute Engine
- SUBNETWORK-NAME: il nome della sottorete Compute Engine
A seconda della tua scelta, sostituisci una delle seguenti opzioni:
Tag di rete per Dataflow
I tag di rete sono attributi di testo che puoi collegare alle VM Compute Engine. I tag di rete ti consentono di creare regole firewall e determinate route statiche personalizzate applicabili a VM specifiche di Compute Engine. Dataflow supporta l'aggiunta di tag di rete a tutte le VM worker che eseguono un determinato job Dataflow.
Anche se non utilizzi il parametro network, Dataflow aggiunge sempre il
tag di rete predefinito dataflow
a ogni VM worker creata.
Abilita tag di rete
Puoi specificare i tag di rete solo quando esegui Dataflow modello di job per creare un job. Una volta avviato un job, non puoi aggiungere altri tag di rete. Per applicare tag di rete aggiuntivi a un job, devi ricreare il modello di job con i tag di rete richiesti.
Aggiungi quanto segue al codice della pipeline, indipendentemente dal fatto che venga eseguito in Java o Python:
--experiments=use_network_tags=TAG-NAME
Sostituisci TAG-NAME con i nomi dei tag. Se aggiungi
più di un tag, separa ogni tag con un punto e virgola (;
), come mostrato di seguito
formato: TAG-NAME-1;TAG-NAME-2;TAG-NAME-3;....
Anche se non utilizzi questo parametro, Dataflow aggiunge sempre il
tag di rete dataflow
a ogni VM worker creata.
Abilita i tag di rete per le VM dei modelli flessibili
Quando utilizzi i modelli flessibili, per attivare i tag di rete per le VM worker di Dataflow, utilizza l'opzione --additional-experiments
come mostrato nell'esempio seguente:
--additional-experiments=use_network_tags=TAG-NAME
Per abilitare i tag di rete sia per le VM worker sia per le VM di avvio, devi usare le due opzioni seguenti:
--additional-experiments=use_network_tags=TAG-NAME
--additional-experiments=use_network_tags_for_flex_templates=TAG-NAME
Sostituisci TAG-NAME con i nomi dei tag. Se aggiungi più di un tag, separali con un punto e virgola (;
), come mostrato nel seguente formato: TAG-NAME-1;TAG-NAME-2;TAG-NAME-3;....
Dopo aver attivato i tag di rete, questi vengono analizzati e collegati alle VM.
Vedi i limiti applicabili ai tag di rete.
Regole firewall per Dataflow
Le regole firewall ti consentono di consentire o negare il traffico da e verso le tue VM. Se i tuoi job Dataflow utilizzano Dataflow Shuffle o Streaming Engine, non devi configurare alcuna regola del firewall. In caso contrario, devi configurare le regole dei firewall in modo che le VM Dataflow possano inviare e ricevere traffico di rete sulla porta TCP 12345
per i job di streaming e sulla porta TCP 12346
per i job batch.
Un proprietario, un editor o un amministratore della sicurezza del progetto
creare le regole firewall necessarie nella rete VPC utilizzata
delle tue VM Dataflow.
Prima di configurare le regole del firewall per Dataflow, leggi i seguenti documenti:
Panoramica delle regole firewall VPC e Utilizzo delle regole firewall
Panoramica dei criteri firewall gerarchici e Utilizzo dei criteri firewall gerarchici
Quando crei regole firewall per Dataflow, specifica Tag di rete Dataflow. In caso contrario, le regole firewall si applicano a tutte le VM nella rete VPC.
Ove applicabili, i criteri firewall gerarchici vengono valutati per primi e queste regole hanno la precedenza sulle regole firewall VPC. Se il job Dataflow si trova in un progetto che fa parte di una cartella o di un'organizzazione in cui vengono utilizzati criteri di firewall gerarchici, è necessario il ruolo compute.orgFirewallPolicyAdmin
per apportare modifiche ai criteri.
Se non hai creato tag di rete personalizzati quando hai eseguito il codice della pipeline,
le VM Dataflow utilizzano il tag dataflow
predefinito. In assenza di una rete personalizzata
, crea le regole firewall con il tag dataflow
predefinito.
Se hai creato tag di rete personalizzati quando hai eseguito il codice della pipeline, le VM Dataflow useranno questi tag. Crea le regole firewall con i tag personalizzati.
Alcune reti VPC, ad esempio la default
creata automaticamente
rete, includi una regola default-allow-internal
che soddisfi il firewall
requisito per Dataflow.
Esempio di regola firewall in entrata
La regola firewall in entrata consente alle VM Dataflow di ricevere pacchetti l'uno dall'altro. Devi sempre creare regole firewall per consentire il traffico in entrata, altrimenti il traffico sarà sempre bloccato, anche se le regole in uscita lo consentono.
Nell'esempio seguente, viene creata una regola firewall in entrata per
Dataflow, in cui tutte le VM worker hanno il tag di rete predefinito dataflow
. Un proprietario, un editor o un amministratore della sicurezza del progetto può utilizzare quanto segue
Comando gcloud
per creare una regola di autorizzazione in entrata che consenta il traffico su TCP
porte 12345
e 12346
dalle VM con il tag di rete dataflow
ad altre VM con
lo stesso tag:
gcloud compute firewall-rules create FIREWALL_RULE_NAME_INGRESS \
--action=allow \
--direction=ingress \
--network=NETWORK \
--target-tags=CUSTOM_TAG \
--source-tags=CUSTOM_TAG \
--priority=PRIORITY_NUM \
--rules tcp:12345-12346
Sostituisci quanto segue:
FIREWALL_RULE_NAME_INGRESS
: un nome per la regola firewallNETWORK
: il nome della rete utilizzata dalle VM workerCUSTOM_TAG
: un elenco di tag di rete delimitato da virgoleDi seguito è riportato un elenco di linee guida per l'uso dei tag di rete:
Se ometti
--target-tags
, la regola viene applicata a tutte le VM nella rete VPC.Se ometti
--source-tags
e tutte le altre specifiche dell'origine, il traffico proveniente da qualsiasi origine è consentito.Se non hai specificato tag di rete personalizzati e vuoi che la regola sia specifica per le VM Dataflow, utilizza
dataflow
come tag di rete.Se hai specificato tag di rete personalizzati e vuoi che la regola sia specifica per le VM Dataflow, utilizza i tag di rete personalizzati.
PRIORITY_NUM
: la priorità della regola firewallI numeri più bassi hanno priorità più elevate e 0 è la priorità più alta.
Esempio di regola firewall in uscita
La regola del firewall in uscita consente alle VM Dataflow di inviare pacchetti l'una all'altra. Se del firewall in uscita, potresti dover creare regole regole firewall di autorizzazione in uscita nella tua rete VPC.
In questo esempio viene creata una regola di uscita del firewall per Dataflow,
dove tutte le VM worker hanno il tag di rete predefinito dataflow
. Un proprietario, un editor o un amministratore della sicurezza del progetto può utilizzare il seguente comando gcloud
per creare una regola di autorizzazione in uscita che consenta il traffico dalle porte TCP 12345
e 12346
sulle VM con il tag di rete dataflow
ad altre VM con lo stesso tag:
gcloud compute firewall-rules create FIREWALL_RULE_NAME_EGRESS \
--network=NETWORK \
--action=allow \
--direction=egress \
--target-tags=CUSTOM_TAG \
--source-tags=CUSTOM_TAG \
--destination-ranges=DESTINATION-RANGES\
--priority=PRIORITY_NUM \
--rules tcp:12345-12346
Sostituisci quanto segue:
FIREWALL_RULE_NAME_EGRESS
: un nome per la regola firewallNETWORK
: il nome della rete su cui il worker Le VM utilizzanoCUSTOM_TAG
: un elenco di tag di rete delimitato da virgoleDi seguito è riportato un elenco di linee guida per l'uso dei tag di rete:
Se ometti
--target-tags
, la regola viene applicata a tutte le VM nella rete VPC.Se ometti
--source-tags
e tutte le altre specifiche dell'origine, il traffico proveniente da qualsiasi origine è consentito.Se non hai specificato tag di rete personalizzati e vuoi che la regola sia specifica per le VM Dataflow, utilizza
dataflow
come tag di rete.Se hai specificato tag di rete personalizzati e vuoi che la regola sia specifica per le VM Dataflow, utilizza i tag di rete personalizzati.
DESTINATION-RANGES
: un elenco di CIDR delimitato da virgoleIncludi l'intervallo di indirizzi IP principale della subnet selezionata.
PRIORITY_NUM
: la priorità della regola firewallI numeri più bassi hanno priorità più elevate e 0 è la priorità più alta.
Per le porte TCP specifiche utilizzate da Dataflow, puoi visualizzare il manifest del contenitore del progetto. Il manifest del container specifica esplicitamente le porte per mappare le porte dell'host nel container.
Accesso SSH alle VM di lavoro
Dataflow non richiede SSH; tuttavia, SSH è utile risoluzione dei problemi.
Se la tua VM worker ha un indirizzo IP esterno, puoi connetterti a
alla VM tramite
dalla console Google Cloud o utilizzando Google Cloud CLI. Per connetterti
tramite SSH, devi disporre di una regola del firewall che consenta le connessioni in entrata sulla porta TCP
22 da almeno l'indirizzo IP del sistema su cui stai eseguendo
gcloud
o del sistema su cui è in esecuzione il browser web che utilizzi per accedere alla
console Google Cloud.
Puoi visualizzare la configurazione e l'attività di rete aprendo una sessione SSH su uno dei tuoi worker ed eseguendo iproute2
. Per ulteriori informazioni, consulta la pagina iproute2
.
Se devi connetterti a una VM worker che ha solo un indirizzo IP interno, consulta Scegli un'opzione di connessione per le VM solo interne.
Passaggi successivi
- Scopri di più su Connectivity Tests. Connectivity Tests è uno strumento di diagnostica che consente di verificare e la connettività tra endpoint di rete.
- Crea ed esegui test di connettività.