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_NUMBERpelo 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:
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.Confirme o projeto em que você está ativando as APIs e clique em Próxima.
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
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.
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:
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.
Renomeie a chave como
key.jsone salve-a em um local seguro.Depois de receber o dispositivo, faça upload de
key.jsonpara o diretório/tmpno dispositivo.