Preparar-se para a transferência on-line

A transferência on-line requer configuração na primeira vez. As transferências posteriores após a configuração inicial não exigem essas etapas.

A maneira mais simples de concluir essa configuração é usar a lista de verificação no console doGoogle Cloud , conforme descrito em Configuração do projeto e download de chaves. A lista de verificação ativa apenas as APIs Transfer Appliance, Pub/Sub e Storage Transfer, cria a conta de serviço do appliance e concede papéis às contas de serviço.

Siga as instruções nesta página se quiser configurar a transferência on-line manualmente, por exemplo, para conceder apenas os papéis mínimos necessários ou usar uma conta de serviço que pertença a um projeto diferente.

Contas de serviço usadas para transferência on-line

A transferência on-line usa as duas identidades a seguir:

  • Conta de serviço do dispositivo: uma conta de serviço gerenciado pelo usuário com uma chave (key.json) que você faz upload para o dispositivo. O dispositivo usa essa conta de serviço para criar e executar jobs do Serviço de transferência do Cloud Storage, publicar e receber mensagens do Pub/Sub e fazer upload dos dados para o bucket de destino. A lista de verificação de configuração cria essa conta de serviço quando você clica em Criar conta de serviço. Você também pode criar um.

  • Agente de serviço do Serviço de transferência do Cloud Storage do seu projeto: um agente de serviço gerenciado pelo Google com o seguinte formato:

    project-PROJECT_NUMBER@storage-transfer-service.iam.gserviceaccount.com
    

    Substitua PROJECT_NUMBER pelo número do projeto que contém o bucket de destino.

Ative as APIs

Para concluir a configuração inicial da transferência on-line, um administrador do Google Cloud precisa ativar as seguintes APIs:

  • API Google Storage Transfer (storagetransfer.googleapis.com)
  • API Pub/Sub (pubsub.googleapis.com)
  • API Cloud Storage (storage.googleapis.com)

Se você ativar o Cloud Monitoring, também será necessário ativar a API Cloud Monitoring (monitoring.googleapis.com).

Ative as APIs nos seguintes projetos:

  • O projeto em que você pediu o dispositivo, que contém o bucket de destino.
  • Se a conta de serviço do dispositivo pertencer a um projeto diferente, também o projeto que contém a conta de serviço do dispositivo. As solicitações de API do dispositivo são verificadas em relação ao projeto que é proprietário da conta de serviço. Se as APIs não estiverem ativadas nesse projeto, a transferência on-line vai falhar com um erro semelhante a Storage Transfer API has not been used in project PROJECT_NUMBER before or it is disabled.

Para ativar as APIs em um projeto, faça o seguinte:

  1. Ative as APIs Storage Transfer, Pub/Sub e Cloud Storage, se ainda não estiverem ativadas.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar as APIs

    1. Confirme o projeto em que você está ativando as APIs e clique em Próxima.

    2. Clique em Ativar.

Como alternativa, execute o seguinte comando:

gcloud services enable storagetransfer.googleapis.com pubsub.googleapis.com storage.googleapis.com --project=PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto em que as APIs serão ativadas.

Configurar o agente de serviço do Serviço de transferência do Cloud Storage

Conceda o seguinte papel ao agente de serviço do Serviço de transferência do Cloud Storage do seu projeto no projeto em que você pediu o dispositivo:

  • Pub/Sub Editor (roles/pubsub.editor)

Conceda um dos seguintes papéis ao agente de serviço do Serviço de transferência do Cloud Storage para o bucket de destino:

  • Storage Object Admin (roles/storage.objectAdmin), o papel mínimo necessário.
  • Storage Admin (roles/storage.admin), o papel que a lista de verificação de configuração concede.

Criar e configurar uma conta de serviço gerenciado pelo usuário

  1. Crie uma conta de serviço gerenciado pelo usuário. Essa é a conta de serviço do dispositivo.

    A conta de serviço pode estar no projeto em que você pediu o dispositivo ou em um projeto diferente, por exemplo, se a organização não permitir que as chaves da conta de serviço sejam criadas no projeto do pedido. Se você usar um projeto diferente, ative as APIs nele também.

  2. Conceda papéis à conta de serviço gerenciado pelo usuário no projeto em que você pediu o dispositivo e para o bucket de destino. Conceda esses papéis no projeto de pedido e no bucket de destino, mesmo que a conta de serviço pertença a um projeto diferente.

    A tabela a seguir lista os papéis mínimos exigidos pela transferência on-line e os papéis mais amplos concedidos pela lista de verificação de configuração:

    Onde conceder Papéis mínimos Papéis concedidos pela checklist de configuração
    Projeto
    • Storage Transfer Agent (roles/storagetransfer.transferAgent)
    • Storage Transfer User (roles/storagetransfer.user)
    • Pub/Sub Editor (roles/pubsub.editor)
    • Monitoring Metric Writer (roles/monitoring.metricWriter)
    • Storage Transfer Admin (roles/storagetransfer.admin)
    • Pub/Sub Editor (roles/pubsub.editor)
    • Monitoring Metric Writer (roles/monitoring.metricWriter)
    • Storage Admin (roles/storage.admin)
    Bucket de destino
    • Storage Object Admin (roles/storage.objectAdmin)
    • Storage Legacy Bucket Reader (roles/storage.legacyBucketReader)
    Nenhuma. O papel Storage Admin (roles/storage.admin) para envolvidos no projeto abrange o bucket.

Depois que a conta de serviço estiver configurada, prepare uma chave de conta de serviço:

  1. Crie uma chave de conta de serviço para a conta de serviço gerenciada pelo usuário. A chave é salva quando você a cria, e não é possível fazer o download dela novamente.

  2. Renomeie a chave como key.json e salve-a em um local seguro.

  3. Depois de receber o dispositivo, faça upload de key.json para o diretório /tmp no dispositivo.