Configure a loja de metadados do seu projeto

O Vertex ML Metadata permite-lhe acompanhar e analisar os metadados produzidos pelos seus fluxos de trabalho de aprendizagem automática (ML). Quando executa um PipelineJob ou cria uma experiência no SDK Vertex pela primeira vez, o Vertex AI cria o MetadataStore do seu projeto.

Se quiser que os seus metadados sejam encriptados com uma chave de encriptação gerida pelo cliente (CMEK), tem de criar o seu arquivo de metadados com uma CMEK antes de usar o Vertex ML Metadata para monitorizar ou analisar metadados.

Depois de criar o repositório de metadados, a chave CMEK que o repositório de metadados usa é independente da chave CMEK usada pelos processos que registam metadados, por exemplo, uma execução de pipeline.

Crie um repositório de metadados que use uma CMEK

Siga as instruções abaixo para criar uma CMEK e configurar um arquivo de metadados do Vertex ML Metadata que use esta CMEK.

1. Use o Cloud Key Management Service para configurar uma chave de encriptação gerida pelo cliente.

2. Use a seguinte chamada REST para criar o arquivo de metadados predefinido do seu projeto com a sua CMEK.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • LOCATION_ID: a sua região.
   • PROJECT_ID: o seu ID do projeto.
   • KEY_RING: o nome do conjunto de chaves do Cloud Key Management Service no qual se encontra a sua chave de encriptação.
   • KEY_NAME: o nome da chave de encriptação que quer usar para esta loja de metadados.

   Método HTTP e URL:

   POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/metadataStores?metadata_store_id=default

   Corpo JSON do pedido:

   {
     "encryption_spec": {
       "kms_key_name": "projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
     },
   }
   

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual:

   cat > request.json << 'EOF'
   {
     "encryption_spec": {
       "kms_key_name": "projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
     },
   }
   EOF

   Em seguida, execute o seguinte comando para enviar o seu pedido REST:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/metadataStores?metadata_store_id=default"

   PowerShell (Windows)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual:

   @'
   {
     "encryption_spec": {
       "kms_key_name": "projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
     },
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Em seguida, execute o seguinte comando para enviar o seu pedido REST:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/metadataStores?metadata_store_id=default" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   {
     "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATIONS_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateMetadataStoreOperationMetadata",
       "genericMetadata": {
         "createTime": "2021-05-18T18:47:14.494997Z",
         "updateTime": "2021-05-18T18:47:14.494997Z"
       }
     }
   }