Ir para o conteúdo

AWS S3 Obtenha o plugin (obsoleto) para Jitterbit Cloud e grupos de agentes privados

Introdução

O plugin AWS S3 Get lê, renomeia ou exclui um arquivo do Amazon AWS S3. Um arquivo que é lido pode ser usado como uma fonte em uma operação.

Este plugin está disponível por padrão em grupos de agentes de nuvem Jitterbit e também pode ser associado a grupos de agentes privados.

Esta página detalha as etapas para usar o plugin AWS S3 Get:

  1. Baixe e adicione o plugin
  2. Associe o plugin a um grupo de agentes
  3. Atribuir o plugin a uma fonte
  4. Defina variáveis globais para o plugin
  5. Configuração completa da operação

Importante

Os plugins fornecidos pelo Jitterbit estão obsoletos. Veja Deprecation and support em Plugins.

Criptografia

O plugin AWS S3 Get passa o ID da chave de acesso AWS S3 fornecido e a chave de acesso secreta (descrita abaixo em Definir variáveis globais para o plugin) para a Amazon. A segurança é tratada pela Amazon conforme descrito na documentação da Amazon sobre Credenciais de segurança da AWS.

Uso

O plugin AWS S3 Get pode ser usado sempre que você precisar recuperar, renomear ou excluir arquivos da AWS.

Funcionalidade adicional

Além disso, essas opções oferecem funcionalidade adicional além do plugin AWS S3 Get:

Baixe e adicione o plugin

O plugin AWS S3 Get é um plugin Jitterbit padrão que já está disponível no Management Console Plugins e não precisa ser baixado ou adicionado à organização.

Se orientado pelo suporte, este plugin pode ser baixado no link fornecido abaixo e adicionado à organização.

Associe o plugin a um grupo de agentes

O plugin AWS S3 Get é associado aos grupos de agentes de nuvem Jitterbit por padrão.

Se estiver usando um grupo de agentes privados, antes de poder usar o plugin, você deve associá-lo ao grupo de agentes privados para tornar o plugin disponível para todos os agentes do grupo.

O plugin está listado no Management Console Plugins página com um nome de exibição de Jitterbit AWS S3 Get.

Atribuir o plugin a uma fonte

Em um projeto do Design Studio, você deve atribuir o plugin a uma fonte dentro de uma operação. Um exemplo de configuração de operação é fornecido no final desta página.

Dentro do projeto:

  1. Criar uma operação. Qualquer operação que utilize uma fonte pode ser usada.
  2. Crie uma fonte fictícia à qual o plugin será atribuído. Esta fonte é usada como um espaço reservado e não será realmente lida. Recomendamos usar uma fonte de variável global. Se outras fontes de tipo de arquivo forem usadas, como Armazenamento Temporário, arquivo local, ou FTP, durante a configuração da fonte, é recomendável fornecer um valor Obter arquivos de [file].[ext].
  3. Atribua o plugin à fonte. Para fazer isso, clique com o botão direito do mouse na fonte e selecione Plugin. No pop-up, em Plugins disponíveis, selecione "Jitterbit AWS S3 Get" e clique em Atribuir. Em seguida, clique em OK.

Dica

A documentação detalhada sobre a atribuição de plug-ins está disponível em Aplicando plug-ins de pipeline.

Definir variáveis globais para o plugin

Para que um plugin atribuído a uma fonte seja funcional, quaisquer variáveis globais requerido pelo plugin deve ser definido. Essas variáveis são definidas em um script, que deve ser colocado antes da fonte na operação para que as variáveis possam ser inicializadas.

Para adicionar um script antes da fonte:

  1. Clique com o botão direito do mouse na fonte na operação e selecione Inserir antes disto > Script.

  2. Crie um novo Jitterbit Script que define variáveis usadas pelo plugin para autenticar com seu bucket S3 e ler o arquivo que você especificar. Um modelo de script para variáveis necessárias é fornecido abaixo, seguido por documentação sobre todas as variáveis possíveis que podem ser incluídas no script.

    AWS S3 Get Script
    <trans>
    $AWS.S3.BUCKET_NAME="<YOUR_BUCKET_NAME>";
    $AWS.S3.ACCESS_KEY_ID="<YOUR_ACCESS_KEY>";
    $AWS.S3.SECRET_ACCESS_KEY="<YOUR_SECRET_KEY>";
    $AWS.S3.OBJECT_KEY="<myfile.txt>";
    </trans>
    
Nome Tipo Obrigatório. Descrição
AWS.S3.ENDPOINT String Opcional A URL do endpoint Amazon AWS S3. O padrão é "s3.amazonaws.com" se não estiver definido. Nomes de endpoint válidos por região são fornecidos na documentação da Amazon Regiões e Endpoints da AWS.
AWS.S3.BUCKET_NAME String Obrigatório O nome do bucket de origem do S3. Para ler de dentro de uma pasta dentro do bucket, adicione o nome da pasta após uma barra (por exemplo, "my_bucket/folder").
AWS.S3.ACCESS_KEY_ID String Obrigatório A chave de acesso S3 (por exemplo "ABCDEFGHI1JK2LM3NOPQ").
AWS.S3.SECRET_ACCESS_KEY String Obrigatório A chave de acesso secreta do S3 (por exemplo, "1aBCd2e/F34gH56IJ7Kl/Mno8pqRsTUvw9x0yzzz").
AWS.S3.REGION String Opcional A região S3. O padrão é "DEFAULT_REGION" se não for definido (não recomendado). Os nomes de regiões atuais são fornecidos na documentação da Amazon Regiões e Endpoints da AWS.
AWS.S3.OBJECT_KEY String Obrigatório A chave do objeto S3 a ser lida. Este é o nome do arquivo específico que você deseja que seja retornado, como "myfile.txt". A chave do objeto diferencia maiúsculas de minúsculas. Não há suporte para especificar vários arquivos ou usar curingas.
AWS.S3.DELETE Booleano Opcional Se definido como "true", exclui o objeto do bucket S3 após lê-lo. O padrão é "false". Não use com o AWS.S3.NEWNAME variável.

Aviso

Esta variável exclui o objeto especificado no próprio bucket S3.

AWS.S3.NEWNAME String Opcional O nome usado para renomear o objeto no bucket S3 após lê-lo. Usar esta variável alterará a chave do objeto S3. Não use com o AWS.S3.DELETE variável.

Aviso

Esta variável exclui o objeto especificado no próprio bucket S3.

Aviso

Embora incluída no manifesto do plugin, a variável AWS.S3.OBJECT_KEY_PREFIX não está funcional. No momento, não é possível ler vários arquivos de uma vez; apenas um arquivo pode ser lido por vez.

Cuidado

Algumas das variáveis acima não devem ser usadas em combinação com outras. Se forem usadas juntas, isso causará erros com sua operação.

Configuração completa da operação

A parte do plugin da configuração da operação é concluída depois que você tem (1) o script definindo as variáveis a serem usadas com o plugin e (2) o plugin atribuído a uma fonte na operação.

Para concluir a configuração da sua operação, defina um alvo para arquivar seus dados S3 ou adicionar um destino e uma transformação se você quiser transformar seus dados antes de atingir o alvo.

operação de configuração

Cuidado

Se estiver usando um Armazenamento Temporário, arquivo local, ou site FTP alvo, para que o nome do arquivo S3 e a extensão sejam gravados no alvo, é recomendável inserir [AWS.S3.OBJECT_KEY] no campo Nome(s) do(s) arquivo(s) para usar o mesmo nome de arquivo no destino que está sendo lido pelo plugin. Usando um valor de [file].[ext] retornará o ID S3 do arquivo em vez do nome do arquivo S3.