Para controlar las conexiones de las VMs que ejecutan una tarea, especifica una red con el acceso deseado. Por ejemplo, puedes especificar una red que permita que un trabajo acceda a los recursos requeridos o limita el acceso para mejorar la seguridad. Como alternativa, si no tienes ningún requisito de red y no quieres configurar una red para un trabajo, omite especificar la red para usar la configuración de red predeterminada.
Para obtener más información sobre los conceptos de redes y cuándo configurarlas, consulta la descripción general de las redes por lotes.
Antes de comenzar
- Si nunca antes usaste Batch, consulta Cómo comenzar a usar Batch y habilita Batch completando los requisitos previos para proyectos y usuarios.
-
Para obtener los permisos que necesitas para crear un trabajo que se ejecute en una red específica, pídele a tu administrador que te otorgue los siguientes roles de IAM:
-
Editor de trabajos por lotes (
roles/batch.jobsEditor
) en el proyecto -
Usuario de cuenta de servicio (
roles/iam.serviceAccountUser
) en la cuenta de servicio del trabajo, que, de forma predeterminada, es la cuenta de servicio predeterminada de Compute Engine -
Para identificar la red y la subred, sigue estos pasos:
Visualizador de la red de Compute (
roles/compute.networkViewer
) en el proyecto
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
-
Editor de trabajos por lotes (
-
Identifica la red que deseas usar para el trabajo. La red que especifiques para un trabajo debe cumplir con los siguientes requisitos:
- La red es una red de nube privada virtual (VPC) que se encuentra en el mismo proyecto que la tarea o es una red de VPC compartida que aloja el proyecto de la tarea o se comparte con él.
- La red incluye una subred en la ubicación en la que deseas ejecutar la tarea.
-
La red permite el acceso necesario para tu trabajo. Por ejemplo, si tu trabajo requiere comunicación entre VMs, como un trabajo que usa bibliotecas MPI para comunicarse entre tareas estrechamente vinculadas, asegúrate de que la red tenga una regla de firewall que permita conexiones entre las VMs del trabajo.
Obtén más información para configurar reglas de firewall de VPC para casos de uso comunes.
-
Si quieres que un trabajo se ejecute en una subred de una red de VPC compartida que esté
alojado por otro proyecto, el estado
Agente de servicio por lotes
debe tener permiso para usar esa subred.
Para asegurarte de que el agente de servicio de Batch de tu proyecto tenga permisos para crear un trabajo que se ejecute en una subred de una red de VPC compartida, pedirle a tu administrador que otorgue al agente de servicio de Batch de tu proyecto Función de IAM de usuario de la red de Compute (
roles/compute.networkUser
) en la subred de VPC compartida.Para obtener más información, consulta la documentación del cómo configurar una VPC compartida para cuentas de servicio.
Crear un trabajo que se ejecute en una red específica
Especifica la red de un trabajo cuando lo creas. Específicamente, debes especificar una red de VPC y una subred que se encuentra donde quieres ejecutar este trabajo.
Si quieres usar una plantilla de instancias de VM cuando crees este trabajo, debes especificar la red en la plantilla de instancias de VM. De lo contrario, sigue estos pasos para especificar la red para un trabajo con gcloud CLI o la API de Batch.
gcloud
Para crear un trabajo que se ejecute en una red específica con la CLI de gcloud, selecciona una de las siguientes opciones:
- Usa las marcas de gcloud para especificar la red para un trabajo
- Cómo usar campos JSON para especificar la red de un trabajo
Usa marcas de gcloud para especificar la red de un trabajo
Para crear un trabajo y usar marcas de gcloud para especificar la red del trabajo, completa los siguientes pasos:
Crea un archivo JSON que especifique los detalles de configuración de tu trabajo.
Por ejemplo, para crear una tarea de secuencia de comandos básica, crea un archivo JSON con el siguiente contenido.
{ "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 el trabajo con el comando
gcloud batch jobs submit
. Para especificar la red en la que se realiza el trabajo, incluye el Las marcas--network
y--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
Reemplaza lo siguiente:
JOB_NAME
: Es el nombre de este trabajo.LOCATION
: La ubicación de este trabajo.JSON_CONFIGURATION_FILE
: Es la ruta de acceso del Archivo JSON con los detalles de configuración del trabajo.HOST_PROJECT_ID
: el ID del proyecto del proyecto para la red que especifiques:- Si usas una red de VPC compartida, especifica el proyecto host.
- De lo contrario, especifica el proyecto actual.
NETWORK
: Es el nombre de una red de VPC en el proyecto actual o una red de VPC compartida que aloja o comparte el proyecto actual.REGION
: Es la región en la que se encuentran la subred y las VMs del trabajo:- Si incluyes el
campo
allowedLocations
para especificar la ubicación permitida para las VMs del trabajo, debes especificar la misma región aquí. - De lo contrario, la región debe ser la misma que la ubicación que selecciones para el trabajo (
LOCATION
).
- Si incluyes el
campo
SUBNET
: Es el nombre de un subnet que es parte del red de VPC y se encuentra en la misma región que la VMs para el trabajo.
Usa campos JSON para especificar la red de un trabajo
Para crear una tarea y usar campos en el archivo de configuración JSON para especificar la red de la tarea, completa los siguientes pasos:
Crea un archivo JSON que especifique los detalles de configuración de tu trabajo. Para especificar la red para el trabajo, incluye la Campos
network
ysubnetwork
.Por ejemplo, para crear una tarea de secuencia de comandos básica que se ejecute en una red específica, crea un archivo JSON con el siguiente contenido.
{ "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" } }
Reemplaza lo siguiente:
HOST_PROJECT_ID
: el ID del proyecto del proyecto para la red que especifiques:- Si usas una red de VPC compartida, especifica el proyecto host.
- De lo contrario, especifica el proyecto actual.
NETWORK
: Es el nombre de una red de VPC en el proyecto actual o una red de VPC compartida que aloja o comparte el proyecto actual.REGION
: el region donde la subred y las VMs del trabajo se encuentran en las siguientes ubicaciones:- Si incluyes el
campo
allowedLocations
para especificar la ubicación permitida para las VMs del trabajo, debes especificar la misma región aquí. - De lo contrario, la región debe ser la misma que
location que selecciones para el trabajo
(
LOCATION
).
- Si incluyes el
campo
SUBNET
: Es el nombre de un subnet que es parte del red de VPC y se encuentra en la misma región que la VMs para el trabajo.
Crea el trabajo con el comando
gcloud batch jobs submit
.gcloud batch jobs submit JOB_NAME \ --location LOCATION \ --config JSON_CONFIGURATION_FILE
Reemplaza lo siguiente:
JOB_NAME
: Es el nombre de este trabajo.LOCATION
: el location para este trabajo.JSON_CONFIGURATION_FILE
: Es la ruta del archivo JSON con los detalles de configuración de la tarea.
Java
Node.js
Python
API
Para crear un trabajo con la API de Batch, usa el
Método jobs.create
y especifica los detalles de configuración de tu trabajo.
Para especificar la red del trabajo, incluye los campos network
y subnetwork
.
Por ejemplo, para crear un trabajo de secuencia de comandos básico que se ejecute en un
red específica, realiza la siguiente solicitud 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"
}
}
Reemplaza lo siguiente:
PROJECT_ID
: el ID del proyecto de tu proyecto.LOCATION
: La ubicación de este trabajo.JOB_NAME
: Es el nombre de este trabajo.HOST_PROJECT_ID
: Es el ID del proyecto del proyecto de la red que especificas:- Si usas una red de VPC compartida, especifica el host en un proyecto final.
- De lo contrario, especifica el proyecto actual (
PROJECT_ID
).
NETWORK
: Es el nombre de un Red de VPC en el proyecto actual o una red de VPC compartida alojado en el proyecto actual o que se comparte con él.REGION
: Es la región en la que se encuentran la subred y las VMs del trabajo:- Si incluyes
Campo
allowedLocations
para especificar la ubicación permitida para las VMs del trabajo, debe especificar la misma región aquí. - De lo contrario, la región debe ser la misma que
location que selecciones para el trabajo
(
LOCATION
).
- Si incluyes
Campo
SUBNET
: Es el nombre de una subred que forma parte de la red de VPC y se encuentra en la misma región que las VMs para la tarea.
¿Qué sigue?
- Si tienes problemas para crear o ejecutar una tarea, consulta Solución de problemas.
- Obtén más información sobre las herramientas de redes.
- Obtén más información para crear un trabajo.
- Obtén más información sobre cómo ver trabajos y tareas.