En esta página, se muestra cómo administrar el ciclo de vida de tus entornos de zona de pruebas con el SDK de Python. Puedes enumerar las zonas de pruebas existentes, ver sus detalles, pausarlas y reanudarlas, o borrarlas cuando ya no sean necesarias.
Antes de comenzar
Para administrar zonas de pruebas, necesitas los siguientes roles en tu proyecto:
- Usuario de Agent Platform (
roles/aiplatform.user)
Administrar zonas de pruebas
Puedes enumerar, ver los detalles, pausar, reanudar y borrar los entornos de zona de pruebas asociados con una instancia de Agent Platform. La pausa y la reanudación te permiten anular la programación de los recursos de procesamiento para las zonas de pruebas inactivas y volver a ponerlas en línea más adelante sin perder el estado del sistema de archivos ni la identidad de conexión. Para cambiar la configuración de una zona de pruebas existente, debes borrarla y crear una nueva.
Enumerar zonas de pruebas
Para enumerar todas las zonas de pruebas asociadas con una instancia de Agent Platform, haz lo siguiente:
import agentplatform
client = agentplatform.Client(project='PROJECT_ID', location='LOCATION')
instance_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID'
sandboxes = client.sandboxes.list(name=instance_name)
for sandbox in sandboxes:
print(sandbox.name)
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del Google Cloud proyecto de.LOCATION: La Google Cloud región de tu instancia de Agent Platform. Consulta Regiones admitidas.INSTANCE_ID: Es el ID de la instancia de Agent Platform.
Ver los detalles de la zona de pruebas
Para ver la configuración y el estado de una zona de pruebas específica, haz lo siguiente:
sandbox_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID/sandboxEnvironments/SANDBOX_ID'
sandbox = client.sandboxes.get(name=sandbox_name)
print(sandbox)
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del Google Cloud proyecto de.LOCATION: La Google Cloud región de tu instancia de Agent Platform. Consulta Regiones admitidas.INSTANCE_ID: Es el ID de la instancia de Agent Platform que contiene tu zona de pruebas.SANDBOX_ID: Es el ID de la zona de pruebas existente.
El resultado incluye detalles como la hora de creación, el estado (p.ej., STATE_RUNNING) y la especificación de la zona de pruebas.
Pausar una zona de pruebas
Cuando se pausa una zona de pruebas, se liberan sus recursos de procesamiento y se conserva el estado del disco y los metadatos de conexión. Las zonas de pruebas pausadas cuestan mucho menos que las que están en ejecución y se pueden reanudar en segundos. Usa la pausa cuando una zona de pruebas esté inactiva durante un período prolongado, pero quieras conservar el estado de la sesión y la identidad de conexión para su uso posterior.
Zonas de pruebas pausadas:
- Conservan su ID de zona de pruebas, los metadatos de conexión y cualquier extremo de Private Service Connect.
- Conservan todo el estado del sistema de archivos en el contenedor en el momento de la pausa.
- Realizan la transición a
STATE_PAUSED. Las solicitudes a su extremo del plano de datos muestran errores hasta que las reanudas.
import agentplatform
client = agentplatform.Client(project='PROJECT_ID', location='LOCATION')
sandbox_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID/sandboxEnvironments/SANDBOX_ID'
pause_operation = client.sandboxes.pause(
name=sandbox_name,
config={
"wait_for_completion": True, # Optional. Blocks until the sandbox reaches STATE_PAUSED.
},
)
paused_sandbox = pause_operation.response
print(f"Sandbox {paused_sandbox.name} state: {paused_sandbox.state}") # STATE_PAUSED
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del Google Cloud proyecto de.LOCATION: La Google Cloud región de tu instancia de Agent Platform. Consulta Regiones admitidas.INSTANCE_ID: Es el ID de la instancia de Agent Platform que contiene tu zona de pruebas.SANDBOX_ID: Es el ID de la zona de pruebas existente.
Reanudar una zona de pruebas
Cuando se reanuda una zona de pruebas pausada, se vuelve a poner en línea su procesamiento. La zona de pruebas conserva el mismo ID, el extremo de conexión (incluido cualquier adjunto de servicio de Private Service Connect) y el estado del sistema de archivos que tenía en el momento de la pausa. Las solicitudes del plano de datos se pueden volver a realizar a la zona de pruebas en cuanto se complete la operación de reanudación.
sandbox_name = 'projects/PROJECT_ID/locations/LOCATION/reasoningEngines/INSTANCE_ID/sandboxEnvironments/SANDBOX_ID'
resume_operation = client.sandboxes.resume(
name=sandbox_name,
config={
"wait_for_completion": True, # Optional. Blocks until the sandbox reaches STATE_RUNNING.
},
)
resumed_sandbox = resume_operation.response
print(f"Sandbox {resumed_sandbox.name} state: {resumed_sandbox.state}") # STATE_RUNNING
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del Google Cloud proyecto de.LOCATION: La Google Cloud región de tu instancia de Agent Platform. Consulta Regiones admitidas.INSTANCE_ID: Es el ID de la instancia de Agent Platform que contiene tu zona de pruebas.SANDBOX_ID: Es el ID de la zona de pruebas pausada.
Borrar una zona de pruebas
Para borrar explícitamente un entorno de zona de pruebas y liberar recursos, haz lo siguiente:
client.sandboxes.delete(name=sandbox_name)
print("Sandbox deleted.")