Opções de linha de comando do agente de transferência

Os agentes transferem dados do sistema de arquivos para o Google Cloud. Quando você executar um agente, é possível controlar as opções dele por meio das sinalizações e opções descritas nesta página.

Resumo do comando

sudo docker run [--ulimit memlock=64000000 -d --rm -v host-directory:container-directory]
--env environment-variable=variable-value
gcr.io/cloud-ingest/tsop-agent:latest
{--help | --version | --project-id=project-id}
[--agent-pool=pool-name --agent-id-prefix=id-prefix
--creds-file=credential-file --enable-mount-directory
--hostname=hostname
--kerberos-disable-pa-fx-fast
--log-dir=logs-directory
--max-physical-mem=maximum-memory]

Opções do Docker

--ulimit memlock=64000000
Bloqueia a memória compartilhada de um pool compartilhado do Docker para que ele esteja sempre na memória para ser acessado por várias sessões.
-d

Inicia o contêiner do Docker no modo desvinculado ou em segundo plano. Isso permite que você continue emitindo comandos do terminal Linux.

Para mais informações, consulte -d desvinculado (em inglês)

--rm

Exclui o contêiner e o sistema de arquivos dele quando o Docker é encerrado.

Para mais informações, consulte Limpeza (--rm) (em inglês)

-v host-directory:container-directory

Especifica um ou mais volumes (em inglês) a serem mapeados do host para o contêiner. Ao usar -v, é necessário que host-directory e container-directory sejam iguais. Caso contrário, o Serviço de transferência do Cloud Storage não localizará os arquivos para transferência.

Para mais informações, consulte VOLUME (sistemas de arquivos compartilhados)

--env environment-variable=variable-value

Especifica uma variável de ambiente para o contêiner do Docker. Use esta sinalização para configurar seus agentes e usar um proxy de encaminhamento. Para mais informações, consulte Como usar um proxy de encaminhamento.

Opções do agente

--agent-id-prefix=id-prefix

Um prefixo opcional que é anexado ao ID do agente para ajudar a identificar o agente ou a máquina no console do Google Cloud . Quando um prefixo é usado, o ID do agente é formatado como prefix + hostname + Docker container ID.

--agent-pool=pool-name

O pool de agentes ao qual este agente será adicionado. Se omitido, o agente vai entrar no pool transfer_service_default.

--creds-file=credential-file

Um arquivo de credencial da conta de serviço opcional no formato JSON. Para mais informações sobre como gerar um arquivo de credencial da conta de serviço, consulte Como criar e gerenciar chaves da conta de serviço.

--enable-mount-directory

Informa ao agente que todo o sistema de arquivos do host está montado em /transfer_root no contêiner. Use-o apenas com -v /:/transfer_root, em vez de montagens de volume individuais do Docker -v. O agente adiciona /transfer_root aos caminhos de origem, destino, registro e credencial, e /transfer_root não fica visível nos registros de transferência ou nas amostras de erro.

--help

Exibe uma breve ajuda de uso.

--hostname=hostname

Defina o nome do host em que o agente está sendo executado. Usado para informar o nome do host da máquina em que um agente específico está em execução.

--kerberos-disable-pa-fx-fast

Impede que os agentes usem a negociação FAST com o Kerberos para transferências do HDFS. Use essa flag se o centro de distribuição de chaves (KDC, na sigla em inglês) do Kerberos não for compatível com a negociação FAST.

--log-dir=logs-directory

Um diretório opcional em que o agente grava registros. O diretório padrão é /tmp/.

--max-physical-mem=maximum-memory

Por padrão, os agentes usam um pool de buffers de 8 GiB. Se isso não se encaixar no seu ambiente, será possível especificar um uso máximo de memória relevante nos seguintes formatos:

Valor de max-physical-mem Configuração máxima de memória
6g 6 gibibytes
6gb 6 gibibytes
6GiB 6 gibibytes
--project-id=project-id

String obrigatória do ID do projeto que hospeda os recursos de transferência criados e faturados.

--version

Exibe a versão atual do agente.