Puoi controllare le connessioni per le VM che eseguono un job specificando una rete con l'accesso desiderato. Ad esempio, puoi specificare una rete che consenta a un job di accedere alle risorse richieste o limiti l'accesso per migliorare la sicurezza. In alternativa, se non hai requisiti di networking e non vuoi configurare il networking per un job, salta la specifica della rete per utilizzare la configurazione di networking predefinita.
Per ulteriori informazioni sui concetti di networking e su quando configurare il networking, consulta Panoramica del networking batch.
Prima di iniziare
- Se non hai mai utilizzato Batch, consulta la sezione Guida introduttiva a Batch e attiva Batch completando i prerequisiti per progetti e utenti.
-
Per ottenere le autorizzazioni necessarie per creare un job eseguito su una rete specifica, chiedi all'amministratore di concederti i seguenti ruoli IAM:
-
Batch Job Editor (
roles/batch.jobsEditor
) sul progetto -
Utente service account (
roles/iam.serviceAccountUser
) sul service account del job, che per impostazione predefinita è il service account Compute Engine predefinito -
Per identificare la rete e la subnet:
Compute Network Viewer (
roles/compute.networkViewer
) sul progetto
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
-
Batch Job Editor (
-
Identifica la rete che vuoi
utilizzare per il lavoro. La rete specificata per un job deve soddisfare i seguenti
requisiti:
- La rete è una rete Virtual Private Cloud (VPC) che si trova nello stesso progetto del job o è una rete VPC condivisa ospitata dal progetto per il job o condivisa con quest'ultimo.
- La rete include una subnet nella località in cui vuoi eseguire il job.
-
La rete consente l'accesso richiesto per il tuo job. Ad esempio, se il tuo
job richiede la comunicazione tra VM, ad esempio un
job che utilizza librerie MPI
per comunicare tra attività strettamente accoppiate, assicurati che la rete
disponga di una regola firewall che consenta le connessioni tra le VM del job.
Scopri come configurare le regole firewall VPC per i casi d'uso comuni.
-
Se vuoi che un job venga eseguito su una subnet di una rete VPC condiviso ospitata da un altro progetto, all'agente di servizio Batch del tuo progetto deve essere concessa l'autorizzazione per utilizzare quella subnet.
Per assicurarti che l'agente di servizio Batch del tuo progetto disponga delle autorizzazioni necessarie per creare un job che viene eseguito su una subnet di una rete VPC condiviso, chiedi all'amministratore di concedere all'agente di servizio Batch del tuo progetto il ruolo IAM Utente di rete Compute (
roles/compute.networkUser
) sulla subnet VPC condiviso.
Crea un job che viene eseguito su una rete specifica
Specifica la rete per un job durante la creazione. In particolare, devi specificare una rete VPC e una subnet che si trova nella posizione in cui vuoi eseguire questo job.
Se vuoi utilizzare un modello di istanza VM durante la creazione di questo job, devi specificare la rete nel modello di istanza VM. In caso contrario, segui questi passaggi per specificare la rete per un job utilizzando gcloud CLI o l'API Batch.
gcloud
Per creare un job che viene eseguito su una rete specifica utilizzando gcloud CLI, seleziona una delle seguenti opzioni:
- Utilizzare i flag gcloud per specificare la rete per un job
- Utilizzare i campi JSON per specificare la rete per un job
Utilizza i flag gcloud per specificare la rete per un job
Per creare un job e utilizzare i flag gcloud per specificare la rete per il job, completa i seguenti passaggi:
Crea un file JSON che specifichi i dettagli di configurazione del job.
Ad esempio, per creare un job di script di base, crea un file JSON con i seguenti contenuti.
{ "taskGroups": [ { "taskSpec": { "runnables": [ { "script": { "text": "echo Hello world! This is task ${BATCH_TASK_INDEX}. This job has a total of ${BATCH_TASK_COUNT} tasks." } } ] }, "taskCount": 3 } ], "logsPolicy": { "destination": "CLOUD_LOGGING" } }
Crea il job utilizzando il comando
gcloud batch jobs submit
. Per specificare la rete del job, includi i flag--network
e--subnetwork
.gcloud batch jobs submit JOB_NAME \ --location LOCATION \ --config JSON_CONFIGURATION_FILE \ --network projects/HOST_PROJECT_ID/global/networks/NETWORK \ --subnetwork projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET
Sostituisci quanto segue:
JOB_NAME
: il nome di questo job.LOCATION
: la posizione per questo lavoro.JSON_CONFIGURATION_FILE
: il percorso del file JSON con i dettagli di configurazione del job.HOST_PROJECT_ID
: l'ID progetto del progetto per la rete che specifichi:- Se utilizzi una rete VPC condiviso, specifica il progetto host.
- In caso contrario, specifica il progetto corrente.
NETWORK
: il nome di una rete VPC nel progetto corrente o di una rete VPC condivisa ospitata dal progetto corrente o condivisa con quest'ultimo.REGION
: la regione in cui si trovano la subnet e le VM per il job:- Se includi il
campo
allowedLocations
per specificare la località consentita per le VM del job, devi specificare la stessa regione qui. - In caso contrario, la regione deve corrispondere alla
posizione selezionata per il job
(
LOCATION
).
- Se includi il
campo
SUBNET
: il nome di una subnet che fa parte della rete VPC e si trova nella stessa regione delle VM per il job.
Utilizza i campi JSON per specificare la rete per un job
Per creare un job e utilizzare i campi nel file di configurazione JSON per specificare la rete per il job, completa i seguenti passaggi:
Crea un file JSON che specifichi i dettagli di configurazione del job. Per specificare la rete per il job, includi i campi
network
esubnetwork
.Ad esempio, per creare un job script di base che viene eseguito su una rete specifica, crea un file JSON con i seguenti contenuti.
{ "taskGroups": [ { "taskSpec": { "runnables": [ { "script": { "text": "echo Hello world! This is task ${BATCH_TASK_INDEX}. This job has a total of ${BATCH_TASK_COUNT} tasks." } } ] }, "taskCount": 3 } ], "allocationPolicy": { "network": { "networkInterfaces": [ { "network": "projects/HOST_PROJECT_ID/global/networks/NETWORK", "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET" } ] } }, "logsPolicy": { "destination": "CLOUD_LOGGING" } }
Sostituisci quanto segue:
HOST_PROJECT_ID
: l'ID progetto del progetto per la rete che specifichi:- Se utilizzi una rete VPC condiviso, specifica il progetto host.
- In caso contrario, specifica il progetto corrente.
NETWORK
: il nome di una rete VPC nel progetto corrente o di una rete VPC condivisa ospitata dal progetto corrente o condivisa con quest'ultimo.REGION
: la regione in cui si trovano la subnet e le VM per il job:- Se includi il
campo
allowedLocations
per specificare la località consentita per le VM del job, devi specificare la stessa regione qui. - In caso contrario, la regione deve corrispondere alla
posizione selezionata per il job
(
LOCATION
).
- Se includi il
campo
SUBNET
: il nome di una subnet che fa parte della rete VPC e si trova nella stessa regione delle VM per il job.
Crea il job utilizzando il comando
gcloud batch jobs submit
.gcloud batch jobs submit JOB_NAME \ --location LOCATION \ --config JSON_CONFIGURATION_FILE
Sostituisci quanto segue:
JOB_NAME
: il nome di questo job.LOCATION
: la posizione per questo lavoro.JSON_CONFIGURATION_FILE
: il percorso del file JSON con i dettagli di configurazione del job.
Java
Node.js
Python
API
Per creare un job utilizzando l'API Batch, utilizza il
metodo jobs.create
e specifica i dettagli di configurazione del job.
Per specificare la rete per il job, includi i
campi network
e subnetwork
.
Ad esempio, per creare un job di script di base che viene eseguito su una
rete specifica, invia la seguente richiesta POST
:
POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs?job_id=JOB_NAME
{
"taskGroups": [
{
"taskSpec": {
"runnables": [
{
"script": {
"text": "echo Hello world! This is task ${BATCH_TASK_INDEX}. This job has a total of ${BATCH_TASK_COUNT} tasks."
}
}
]
},
"taskCount": 3
}
],
"allocationPolicy": {
"network": {
"networkInterfaces": [
{
"network": "projects/HOST_PROJECT_ID/global/networks/NETWORK",
"subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET"
}
]
}
},
"logsPolicy": {
"destination": "CLOUD_LOGGING"
}
}
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto del tuo progetto.LOCATION
: la sede per questo lavoro.JOB_NAME
: il nome di questo job.HOST_PROJECT_ID
: l'ID progetto del progetto per la rete che specifichi:- Se utilizzi una rete VPC condiviso, specifica il progetto host.
- In caso contrario, specifica il progetto corrente (
PROJECT_ID
).
NETWORK
: il nome di una rete VPC nel progetto corrente o di una rete VPC condivisa ospitata dal progetto corrente o condivisa con quest'ultimo.REGION
: la regione in cui si trovano la subnet e le VM per il job:- Se includi il
campo
allowedLocations
per specificare la località consentita per le VM del job, devi specificare la stessa regione qui. - In caso contrario, la regione deve corrispondere alla
posizione selezionata per il job
(
LOCATION
).
- Se includi il
campo
SUBNET
: il nome di una subnet che fa parte della rete VPC e si trova nella stessa regione delle VM per il job.
Passaggi successivi
- Se hai problemi a creare o eseguire un job, consulta la sezione Risoluzione dei problemi.
- Scopri di più sul networking.
- Scopri di più sulla creazione di un job.
- Scopri come visualizzare lavori e attività.