View a markdown version of this page

Configurando e iniciando o armazenamento compatível com o Amazon S3 no Snowball Edge - AWS Snowball Edge Guia do Desenvolvedor
Pré-requisitosConfigurar o ambiente localIniciando o armazenamento compatível com Amazon S3 no serviço Snowball EdgeVisualizar informações sobre endpoints

AWS Snowball Edge não está mais disponível para novos clientes. Novos clientes devem explorar AWS DataSynctransferências on-line, o Terminal de Transferência de AWS Dados para transferências físicas seguras ou soluções de AWS parceiros. Para computação de ponta, explore AWS Outposts.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurando e iniciando o armazenamento compatível com o Amazon S3 no Snowball Edge

Instale e configure ferramentas de software em seu ambiente local AWS para interagir com o dispositivo ou cluster de dispositivos Snowball Edge e o armazenamento compatível com o Amazon S3 no Snowball Edge. Em seguida, use essas ferramentas para configurar o dispositivo ou cluster do Snowball Edge e iniciar o armazenamento compatível com o Amazon S3 no Snowball Edge.

Pré-requisitos

O armazenamento compatível com o Amazon S3 no Snowball Edge exige que você tenha o cliente Snowball Edge e o AWS CLI instalado em seu ambiente local. Você também pode usar o SDK para .NETAWS Tools for Windows PowerShell para trabalhar com armazenamento compatível com Amazon S3 no Snowball Edge.AWS recomenda o uso das seguintes versões dessas ferramentas:

Configurar o ambiente local

Esta seção descreve como instalar e configurar o cliente Snowball Edge e seu ambiente local para uso com armazenamento compatível com Amazon S3 no Snowball Edge.

  1. Baixe e instale o Snowball Edge Client. Para ter mais informações, consulte Baixar e instalar o Snowball Edge Client.

  2. Configure um perfil para o Snowball Edge Client. Para ter mais informações, consulte Configurar um perfil para o Snowball Edge Client.

  3. Se você estiver usando SDK para .NET, defina o valor do clientConfig.AuthenticationRegion parâmetro da seguinte forma:

    
  clientConfig.AuthenticationRegion = "snow"

Configuração de seu dispositivo Snowball Edge

Configurar o IAM no Snowball Edge

AWS Identity and Access Management(IAM) ajuda você a habilitar o acesso granular aos AWS recursos que são executados em seus dispositivos Snowball Edge. Com o IAM, você controla quem pode se autenticar (fazer login) e quem tem autorização (permissões) para acessar os recursos.

O IAM é aceito localmente no Snowball Edge. É possível usar o serviço local do IAM para criar perfis e anexar políticas do IAM a eles. É possível usar essas políticas para permitir o acesso necessário para realizar as tarefas atribuídas.

O exemplo a seguir permite acesso total à API do Amazon S3:

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "s3:*",
            "Resource": "*"
        }
    ]
}

Para obter exemplos de políticas do IAM, consulte o Guia do desenvolvedor da AWS Snowball Edge.

Iniciando o armazenamento compatível com Amazon S3 no serviço Snowball Edge

Use as instruções a seguir para iniciar o serviço de armazenamento compatível com Amazon S3 no Snowball Edge em um dispositivo ou cluster do Snowball Edge.

Se preferir uma experiência mais fácil de usar, você pode iniciar o serviço de armazenamento compatível com Amazon S3 no Snowball Edge para um dispositivo independente ou um cluster de dispositivos usando.AWS OpsHub Consulte Configure o armazenamento compatível com o Amazon S3 no Snowball Edge com AWS OpsHub.

  1. Desbloqueie seu dispositivo Snowball Edge ou cluster de dispositivos executando o seguinte comando:

    • Para um único dispositivo:

      
  snowballEdge unlock-device --endpoint https://snow-device-ip

    • Para um cluster:

      
 snowballEdge unlock-cluster

  2. Execute o seguinte comando e verifique se o dispositivo Snowball Edge ou o cluster de dispositivos está desbloqueado:

    • Para um único dispositivo:

      
  snowballEdge describe-device --endpoint https://snow-device-ip

    • Para um cluster:

      
  snowballEdge describe-cluster --device-ip-addresses [snow-device-1-ip] [snow-device-2-ip] /
    [snow-device-3-ip] [snow-device-4-ip] [snow-device-5-ip] /
    [snow-device-6-ip]

  3. Para cada dispositivo (se você tem um ou um cluster), para iniciar o armazenamento compatível com o Amazon S3 no Snowball Edge, faça o seguinte:

    1. Obtenha os PhysicalNetworkInterfaceId dos dispositivos executando o comando describe-device a seguir:

      
  snowballEdge describe-device --endpoint https://snow-device-ip

    2. Execute o comando create-virtual-network-interface a seguir duas vezes para criar as interfaces de rede virtual (VNIs) para os endpoints s3control (para operações de bucket) e s3api (para operações de objetos).

      
  snowballEdge create-virtual-network-interface --ip-address-assignment dhcp --manifest-file manifest --physical-network-interface-id "PhysicalNetworkInterfaceId" --unlock-code unlockcode --endpoint https://snow-device-ip

      O comando retorna uma estrutura JSON que inclui o endereço IP. Anote esse endereço IP.

      Para obter detalhes sobre esses comandos, consulte Configuração de uma interface de rede virtual (VNI) em um Snowball Edge.

      nota

      Iniciar o armazenamento compatível com o Amazon S3 no Snowball Edge consome recursos do dispositivo.

  4. Inicie o armazenamento compatível com o Amazon S3 no serviço Snowball Edge executando o seguinte start-service comando, que inclui os endereços IP dos seus dispositivos e os Amazon Resource Names (ARNs) das VNIs que você criou para os endpoints e. s3control s3api

    Para iniciar o serviço em um único dispositivo:

    
  snowballEdge start-service --service-id s3-snow --device-ip-addresses snow-device-1-ip --virtual-network-interface-arns vni-arn-1 vni-arn-2

    Como iniciar o serviço em um cluster:

    
  snowballEdge start-service --service-id s3-snow --device-ip-addresses snow-device-1-ip snow-device-2-ip snow-device-3-ip --virtual-network-interface-arns vni-arn-1 vni-arn-2 vni-arn-3  vni-arn-4 vni-arn-5 vni-arn-6

    Para --virtual-network-interface-arns, inclua ARNs para todas as VNIs que você criou na etapa anterior. Separe cada ARN usando um espaço.

  5. Execute o comando describe-service a seguir para um único dispositivo:

    
  snowballEdge describe-service --service-id s3-snow

    Espere até que o status do serviço seja Active.

    Execute o comando describe-service a seguir para um cluster:

    
  snowballEdge describe-service --service-id s3-snow \ 
    --device-ip-addresses snow-device-1-ip snow-device-2-ip snow-device-3-ip

Visualização de informações sobre armazenamento compatível com Amazon S3 em endpoints do Snowball Edge

Quando o armazenamento compatível com o Amazon S3 no serviço Snowball Edge está em execução, você pode usar o comando describe-service Snowball Edge Client para visualizar os endereços IP associados aos endpoints s3control e s3api.


snowballEdge describe-service --service-id s3-snow --endpoint https://snow-device-ip-address --profile profile-name
exemplo saída do comando describe-service

Neste exemplo, o endereço IP do endpoint s3control é 192.168.1.222 e o endereço IP do endpoint s3api é 192.168.1.152.


{
  "ServiceId": "s3-snow",
  "Autostart": true,
  "Status": {
    "State": "ACTIVATING",
    "Details": "Attaching storage"
  },
  "ServiceCapacities": [
    {
      "Name": "S3 Storage",
      "Unit": "Byte",
      "Used": 148599705600,
      "Available": 19351400294400
    }
  ],
  "Endpoints": [
    {
      "Protocol": "https",
      "Port": 443,
      "Host": "192.168.1.222",
      "CertificateAssociation": {
        "CertificateArn": "arn:aws:snowball-device:::certificate/30c563f1124707705117f57f6c3accd42a4528ed6dba1e35c1822a391a717199d8c49973d3c0283494d987463e826f2c"
      },
      "Description": "s3-snow bucket API endpoint (for s3control SDK)",
      "DeviceId": "JID-beta-207429000001-23-12-28-03-51-11",
      "Status": {
        "State": "ACTIVE"
      }
    },
    {
      "Protocol": "https",
      "Port": 443,
      "Host": "192.168.1.152",
      "CertificateAssociation": {
        "CertificateArn": "arn:aws:snowball-device:::certificate/30c563f1124707705117f57f6c3accd42a4528ed6dba1e35c1822a391a717199d8c49973d3c0283494d987463e826f2c"
      },
      "Description": "s3-snow object & bucket API endpoint (for s3api SDK)",
      "DeviceId": "JID-beta-207429000001-23-12-28-03-51-11",
      "Status": {
        "State": "ACTIVATING"
      }
    }
  ]
}