AWS Command Line Interface (CLI)

As ferramentas client padrão podem ser usadas para armazenar objetos no Big File Object Storage. Este manual ajudará a configurar ferramentas compatíveis com S3 para funcionarem no Big File. 

A Interface da Linha de Comando (ILC) da AWS é uma ferramenta unificada para o gerenciamento das operações no BigFile. Você poderá realizar as operações do BigFile pela linha de comando e automatizá-los usando scripts.

A ILC da AWS apresenta um novo conjunto de comandos de arquivos simples para transferências eficientes de arquivos de/para o Amazon S3.

Índice

Pré-requisitos


Antes de começar, valide os seguintes processos:


Info

Antes de começar é necessário que você tenha acesso aos parâmetros de uso da API. 

Esse manual mostra como acessá-los: API Big File

Etapa 1: Instalação AWS CLI


Windows


  1. Faça o download do instalador do AWS CLI MSI para Windows (64 bits) em https://awscli.amazonaws.com/AWSCLIV2.msi.
  2. Execute o instalador baixado do MSI e siga as instruções na tela. Por padrão, a CLI da AWS é instalada em C:\Program Files\Amazon\AWSCLIV2.
  3. Para confirmar a instalação, abra o menu Iniciar , procure cmd e abra uma janela do prompt de comando e, no prompt de comando, use o comando aws --version 

    C:\> aws --version
    aws-cli/2.0.6 Python/3.7.4 Windows/10 botocore/2.0.0

    Info

    Se o Windows não conseguir encontrar o programa, talvez seja necessário fechar e reabrir a janela do prompt de comando para atualizar o caminho ou adicionar o diretório de instalação à sua variável de ambiente PATH manualmente.

  4. Atualize o defaut/create um novo perfil para o Big file Object Storage no arquivo de configuração do aws.

Linux


  1. Dependendo de você usar o Linux ou Linux ARM de 64 bits. Veja as descrições de cada linha nas etapas a seguir.

    Linux x86 (64 bits)
    curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
    unzip awscliv2.zip
    sudo ./aws/install
    ARM do Linux
    curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
    unzip awscliv2.zip
    sudo ./aws/install
  2. Confirme a instalação.

    ARM do Linux
    $ aws --version
    aws-cli/2.0.6 Python/3.7.4 Linux/4.14.133-113.105.amzn2.x86_64 botocore/2.0.0

Etapa 2: Configuração AWS S3


Windows


1. Edite os arquivos de configuração do diretório .aws, para verificar a localização desta pasta abra o menu Iniciar , procure cmd e abra uma janela do prompt de comando e, no prompt de comando, use o comando:

C:\> dir "%UserProfile%\.aws"

2. Vá até o diretório e edite os arquivos config credentials inserindo os seguintes parâmetros:

config
[default]
s3 =
   signature_version = s3v4
region = BR
credentials
[default]
aws_access_key_id = <S3 Access Key>
aws_secret_access_key = <S3 Secret Key>


3. Teste as configurações feitas através da linha de comando:

credentials
aws s3 --endpoint-url=https://bigfile.brascloud.com.br ls 
2018-04-01 19:00 mybucket1
2018-04-01 19:10 mybucket1
2018-04-01 19:20 mybucket1

Este comando listará todos os buckets existentes.

Linux


1. Edite os arquivos de configuração do diretório .aws, para verificar a localização desta pasta abra o menu Iniciar , procure cmd e abra uma janela do prompt de comando e, no prompt de comando, use o comando:

$ ls  ~/.aws

2. Vá até o diretório e edite os arquivos config credentials inserindo os seguintes parâmetros:

config
[default]
s3 =
   signature_version = s3v4
region = BR
credentials
[default]
aws_access_key_id = <S3 Access Key>
aws_secret_access_key = <S3 Secret Key>

3. Teste as configurações feitas através da linha de comando:

credentials
aws s3 --endpoint-url=https://bigfile.brascloud.com.br ls 
2018-04-01 19:00 mybucket1
2018-04-01 19:10 mybucket1
2018-04-01 19:20 mybucket1

Este comando listará todos os buckets existentes.

Etapa 3: Uso dos comandos (s3) de nível superior com a AWS CLI


Acesse a documentação oficial da AWS para acessar os comandos para manipulação dos buckets no nosso BigFile.

Próximos passos: