Vous pouvez contrôler les connexions des VM qui exécutent une tâche en spécifiant un réseau disposant de l'accès souhaité. Par exemple, vous pouvez spécifier un réseau qui autorise une tâche à accéder aux ressources requises ou qui limite l'accès pour améliorer la sécurité. Si vous n'avez pas d'exigences de mise en réseau et que vous ne souhaitez pas configurer la mise en réseau pour une tâche, ignorez la spécification du réseau afin d'utiliser la configuration réseau par défaut à la place.
Pour en savoir plus sur les concepts de mise en réseau et sur leur configuration, consultez la page Présentation de la mise en réseau par lots.
Avant de commencer
- Si vous n'avez jamais utilisé Batch, consultez la page Premiers pas avec Batch et activez Batch en remplissant les conditions préalables pour les projets et les utilisateurs.
-
Afin d'obtenir les autorisations nécessaires pour créer une tâche qui s'exécute sur un réseau spécifique, demandez à votre administrateur de vous attribuer les rôles IAM suivants:
-
Éditeur de tâches par lot (
roles/batch.jobsEditor
) sur le projet -
Utilisateur du compte de service (
roles/iam.serviceAccountUser
) sur le compte de service de la tâche, qui est par défaut le compte de service Compute Engine par défaut -
Pour identifier le réseau et le sous-réseau : Lecteur de réseau Compute (
roles/compute.networkViewer
) sur le projet
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
-
Éditeur de tâches par lot (
-
Identifiez le réseau que vous souhaitez utiliser pour cette tâche. Le réseau que vous spécifiez pour une tâche doit répondre aux exigences suivantes :
- Le réseau est un réseau cloud privé virtuel (VPC) qui se trouve dans le même projet que la tâche, ou un réseau VPC partagé hébergé par le projet associé à la tâche ou partagé avec lui.
- Le réseau comprend un sous-réseau à l'emplacement où vous souhaitez exécuter la tâche.
-
Le réseau autorise l'accès requis pour votre tâche. Par exemple, si votre tâche nécessite une communication entre des VM, telle qu'une tâche qui utilise des bibliothèques MPI pour communiquer entre des tâches étroitement couplées, assurez-vous que le réseau dispose d'une règle de pare-feu autorisant les connexions entre les VM associées à la tâche.
Découvrez comment configurer des règles de pare-feu VPC pour les cas d'utilisation courants.
-
Si vous souhaitez qu'une tâche s'exécute sur un sous-réseau d'un réseau VPC partagé hébergé par un autre projet, l'agent de service Batch de votre projet doit être autorisé à utiliser ce sous-réseau.
Pour vous assurer que l'agent de service Batch de votre projet dispose des autorisations nécessaires pour créer une tâche qui s'exécute sur un sous-réseau d'un réseau VPC partagé, demandez à votre administrateur d'attribuer à l'agent de service Batch de votre projet le rôle IAM Utilisateur de réseau Compute (
roles/compute.networkUser
) sur le sous-réseau VPC partagé.Pour en savoir plus, consultez la documentation sur la configuration d'un VPC partagé pour les comptes de service.
Créer un job qui s'exécute sur un réseau spécifique
Spécifiez le réseau d'un job lorsque vous le créez. Plus précisément, vous devez spécifier un réseau VPC et un sous-réseau situé à l'endroit où vous souhaitez exécuter cette tâche.
Si vous souhaitez utiliser un modèle d'instance de VM lors de la création de ce job, vous devez spécifier le réseau dans ce modèle. Sinon, suivez les étapes ci-dessous pour spécifier le réseau d'un job à l'aide de gcloud CLI ou de l'API Batch.
gcloud
Pour créer une tâche qui s'exécute sur un réseau spécifique à l'aide de gcloud CLI, sélectionnez l'une des options suivantes:
- Utiliser des indicateurs gcloud pour spécifier le réseau d'une tâche
- Spécifier le réseau d'une tâche à l'aide de champs JSON
Utiliser des indicateurs gcloud pour spécifier le réseau d'un job
Pour créer une tâche et utiliser des indicateurs gcloud afin de spécifier le réseau de la tâche, procédez comme suit:
Créez un fichier JSON qui spécifie les détails de configuration de votre job.
Par exemple, pour créer une tâche de script de base, créez un fichier JSON avec le contenu suivant.
{ "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" } }
Créez la tâche à l'aide de la commande
gcloud batch jobs submit
. Pour spécifier le réseau auquel la tâche doit s'appliquer, incluez les options--network
et--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
Remplacez les éléments suivants :
JOB_NAME
: nom de cette tâche.LOCATION
: lieu de cette tâche.JSON_CONFIGURATION_FILE
: chemin d'accès au fichier JSON contenant les détails de configuration de la tâche.HOST_PROJECT_ID
: ID de projet du projet pour le réseau que vous spécifiez :- Si vous utilisez un réseau VPC partagé, spécifiez le projet hôte.
- Sinon, spécifiez le projet en cours.
NETWORK
: nom d'un réseau VPC dans le projet en cours ou d'un réseau VPC partagé hébergé par le projet en cours ou partagé avec lui.REGION
: région dans laquelle se trouvent le sous-réseau et les VM pour la tâche :- Si vous incluez le champ
allowedLocations
afin de spécifier l'emplacement autorisé des VM pour la tâche, vous devez spécifier la même région ici. - Sinon, la région doit être identique à l'emplacement que vous avez sélectionné pour la tâche (
LOCATION
).
- Si vous incluez le champ
SUBNET
: nom d'un sous-réseau faisant partie du réseau VPC et situé dans la même région que les VM de la tâche.
Utiliser des champs JSON pour spécifier le réseau d'une tâche
Pour créer une tâche et utiliser des champs du fichier de configuration JSON afin de spécifier le réseau associé à cette tâche, procédez comme suit:
Créez un fichier JSON qui spécifie les détails de configuration de votre job. Pour spécifier le réseau de la tâche, incluez les champs
network
etsubnetwork
.Par exemple, pour créer une tâche de script de base qui s'exécute sur un réseau spécifique, créez un fichier JSON avec le contenu suivant.
{ "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" } }
Remplacez les éléments suivants :
HOST_PROJECT_ID
: ID de projet du projet pour le réseau que vous spécifiez :- Si vous utilisez un réseau VPC partagé, spécifiez le projet hôte.
- Sinon, spécifiez le projet en cours.
NETWORK
: nom d'un réseau VPC dans le projet en cours ou d'un réseau VPC partagé hébergé par le projet en cours ou partagé avec lui.REGION
: région dans laquelle se trouvent le sous-réseau et les VM pour la tâche :- Si vous incluez le champ
allowedLocations
afin de spécifier l'emplacement autorisé des VM pour la tâche, vous devez spécifier la même région ici. - Sinon, la région doit être identique à l'emplacement que vous avez sélectionné pour la tâche (
LOCATION
).
- Si vous incluez le champ
SUBNET
: nom d'un sous-réseau faisant partie du réseau VPC et situé dans la même région que les VM de la tâche.
Créez la tâche à l'aide de la commande
gcloud batch jobs submit
.gcloud batch jobs submit JOB_NAME \ --location LOCATION \ --config JSON_CONFIGURATION_FILE
Remplacez les éléments suivants :
JOB_NAME
: nom de cette tâche.LOCATION
: lieu de cette tâche.JSON_CONFIGURATION_FILE
: chemin d'accès au fichier JSON contenant les détails de configuration de la tâche.
API
Pour créer une tâche à l'aide de l'API Batch, utilisez la méthode jobs.create
et spécifiez les détails de configuration de votre tâche.
Pour spécifier le réseau de la tâche, incluez les champs network
et subnetwork
.
Par exemple, pour créer une tâche de script de base qui s'exécute sur un réseau spécifique, exécutez la requête POST
suivante:
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"
}
}
Remplacez les éléments suivants :
PROJECT_ID
: ID de projet de votre projet.LOCATION
: emplacement de cette tâche.JOB_NAME
: nom de cette tâche.HOST_PROJECT_ID
: ID de projet du projet pour le réseau que vous spécifiez :- Si vous utilisez un réseau VPC partagé, spécifiez le projet hôte.
- Sinon, spécifiez le projet actuel (
PROJECT_ID
).
NETWORK
: nom d'un réseau VPC dans le projet en cours ou d'un réseau VPC partagé hébergé par le projet en cours ou partagé avec lui.REGION
: région dans laquelle se trouvent le sous-réseau et les VM pour la tâche :- Si vous incluez le champ
allowedLocations
afin de spécifier l'emplacement autorisé des VM pour la tâche, vous devez spécifier la même région ici. - Sinon, la région doit être identique à l'emplacement que vous avez sélectionné pour la tâche (
LOCATION
).
- Si vous incluez le champ
SUBNET
: nom d'un sous-réseau faisant partie du réseau VPC et situé dans la même région que les VM de la tâche.
Étapes suivantes
- Si vous rencontrez des problèmes pour créer ou exécuter un job, consultez la section Dépannage.
- En savoir plus sur la mise en réseau
- Découvrez comment créer une tâche.
- Découvrez comment afficher des tâches et des tâches.