Puedes controlar las conexiones de las VM que ejecutan un trabajo si especificas una red con el acceso deseado. Por ejemplo, puedes especificar una red que permita que un trabajo acceda a los recursos necesarios o que limite el acceso para mejorar la seguridad. Como alternativa, si no tienes requisitos de red y no deseas configurarlas para un trabajo, omite especificar la red a fin de usar la configuración de red predeterminada.
Para obtener más información sobre los conceptos de las herramientas de redes y cuándo configurarlas, consulta Descripción general de las redes por lotes.
Antes de comenzar
- Si nunca usaste Batch, revisa Comienza a usar Batch y completa los requisitos previos para proyectos y usuarios a fin de habilitar Batch.
-
A fin de obtener los permisos necesarios 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 es la cuenta de servicio predeterminada de Compute Engine de forma predeterminada -
Para identificar la red y la subred, usa el Visualizador de red de Compute (
roles/compute.networkViewer
) en el proyecto.
Si quieres obtener más información para otorgar funciones, consulta Administra el acceso.
Es posible que también puedas obtener los permisos necesarios mediante funciones personalizadas, o bien otras funciones predefinidas.
-
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 el trabajo o es una red de VPC compartida que se aloja en el proyecto o se comparte con él.
- La red incluye una subred (subred) en la ubicación en la que deseas ejecutar el trabajo.
-
La red permite el acceso requerido para tu trabajo. Por ejemplo, si tu trabajo requiere comunicación entre las VM, como un trabajo que usa bibliotecas MPI para comunicarse entre tareas estrechamente acopladas, asegúrate de que la red tenga una regla de firewall que permita conexiones entre las VM del trabajo.
Obtén información sobre cómo configurar las reglas de firewall de VPC para casos de uso comunes.
-
Si deseas que un trabajo se ejecute en una subred de una red de VPC compartida que está alojada en otro proyecto, el agente de servicio por lotes de tu proyecto debe tener permiso para usar esa subred.
Si quieres asegurarte de que el agente de servicio de Batch de tu proyecto tenga los permisos necesarios para crear un trabajo que se ejecute en una subred de una red de VPC compartida, pídele a tu administrador que le otorgue al agente de servicio de Batch de tu proyecto el rol de IAM de Usuario de la red de Compute (
roles/compute.networkUser
) en la subred de VPC compartida.Si quieres obtener más información, consulta la documentación sobre la configuración de una VPC compartida para cuentas de servicio.
Crea un trabajo que se ejecute en una red específica
Especifica la red para un trabajo cuando lo crees. En particular, debes especificar una red de VPC y una subred ubicada en la ubicación en la que deseas ejecutar este trabajo.
Si deseas usar una plantilla de instancias de VM mientras creas este trabajo, debes especificar la red en la plantilla. De lo contrario, sigue estos pasos a fin de especificar la red para un trabajo con gcloud CLId o la API de Batch.
gcloud
Para crear un trabajo que se ejecute en una red específica con gcloud CLI, selecciona una de las siguientes opciones:
- Usa marcas de gcloud para especificar la red de un trabajo
- Usa campos JSON para especificar la red de un trabajo
Usa marcas de gcloud para especificar la red de un trabajo
Si quieres 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 un trabajo básico de secuencia de comandos, 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 del trabajo, incluye 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
: Es la ubicación de este trabajo.JSON_CONFIGURATION_FILE
: Es la ruta del archivo JSON con los detalles de configuración del trabajo.HOST_PROJECT_ID
: Es el ID 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 se aloja en el proyecto actual o se comparte con él.REGION
: Es la región en la que se encuentran la subred y las VM del trabajo:- Si incluyes el campo
allowedLocations
a fin de especificar la ubicación permitida para las VM 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 una subred que forma parte de la red de VPC y se encuentra en la misma región que las VM del trabajo.
Usa campos JSON para especificar la red de un trabajo
Si deseas crear un trabajo y usar campos en el archivo de configuración JSON para especificar la red del trabajo, 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 los campos
network
ysubnetwork
.Por ejemplo, para crear un trabajo de secuencia de comandos básico que se ejecuta 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
: Es el ID 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 se aloja en el proyecto actual o se comparte con él.REGION
: Es la región en la que se encuentran la subred y las VM del trabajo:- Si incluyes el campo
allowedLocations
a fin de especificar la ubicación permitida para las VM 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 una subred que forma parte de la red de VPC y se encuentra en la misma región que las VM del 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
: Es la ubicación de este trabajo.JSON_CONFIGURATION_FILE
: Es la ruta del archivo JSON con los detalles de configuración del trabajo.
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 para el trabajo, incluye los campos network
y subnetwork
.
Por ejemplo, para crear un trabajo básico de secuencia de comandos que se ejecute en una 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
: Es el ID del proyecto.LOCATION
: Es la ubicación de este trabajo.JOB_NAME
: Es el nombre de este trabajo.HOST_PROJECT_ID
: Es el ID 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 (
PROJECT_ID
).
NETWORK
: Es el nombre de una red de VPC en el proyecto actual o una red de VPC compartida que se aloja en el proyecto actual o se comparte con él.REGION
: Es la región en la que se encuentran la subred y las VM del trabajo:- Si incluyes el campo
allowedLocations
a fin de especificar la ubicación permitida para las VM 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 una subred que forma parte de la red de VPC y se encuentra en la misma región que las VM del trabajo.
¿Qué sigue?
- Si tienes problemas para crear o ejecutar un trabajo, consulta Solución de problemas.
- Obtén más información sobre las herramientas de redes.
- Obtén más información sobre cómo crear un trabajo.
- Aprende a ver trabajos y tareas.