Salvando e restaurando arquivos de sandbox com instantâneos

Crie um snapshot para salvar arquivos do espaço de trabalho e use-o para criar um novo sandbox.

Os snapshots preservam o conteúdo do sistema de arquivos. Eles não preservam processos em execução, execução de comandos ou memória. A restauração de um instantâneo cria um novo sandbox com um novo ID de sandbox.

Salve um instantâneo antes de interromper o sandbox de origem ou permitir que ele expire. Defina a duração da expiração do instantâneo para o período para o qual você precisa de seus arquivos.

profile_name="DEFAULT"
region="us-chicago-1"
sandbox_id="SANDBOX_ID"
project_id="PROJECT_OCID"

Criando um Snapshot

Este exemplo solicita um snapshot com um período de retenção de sete dias:

snapshot_id=$(oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-snapshot create \
  --sandbox-id "$sandbox_id" \
  --expiration-duration P7D \
  --query 'data.id' --raw-output)

Salve o ID do snapshot. Inspecione seu estado de ciclo de vida antes de usá-lo como origem:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-snapshot get \
  --snapshot-id "$snapshot_id"

Criando um Sandbox com Base em um Snapshot

Após a conclusão da criação do instantâneo, crie um novo sandbox usando seu ID:

sandbox_id=$(oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox create-from-snapshot \
  --project-id "$project_id" \
  --source-snapshot-id "$snapshot_id" \
  --display-name restored-sandbox \
  --expiration-duration PT30M \
  --query 'data.id' --raw-output)

Aguarde o novo sandbox chegar a RUNNING. Inicie todos os processos necessários novamente e use o novo ID para comandos e operações de arquivo.

Listando e Inspecionando Snapshots

Listar instantâneos de um projeto. Adicione --sandbox-id para filtrar pelo sandbox de origem:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-snapshot list \
  --project-id "$project_id" \
  --sandbox-id "SOURCE_SANDBOX_ID" \
  --limit 25

O ID do sandbox de origem é o ID usado ao criar o instantâneo, que pode ser diferente do ID de um sandbox restaurado. Use o comando get acima para inspecionar um snapshot.

Deletando um Snapshot

Exclua um instantâneo quando seus arquivos salvos não forem mais necessários para criar sandboxes:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox-snapshot delete \
  --snapshot-id "$snapshot_id"

Revise e confirme o prompt de exclusão de CLI.