Configuración e inicio del almacenamiento compatible con Amazon S3 en los dispositivos de la familia Snow

Instale y configure herramientas de software en su entorno local AWS para interactuar con el dispositivo Snowball Edge o el clúster de dispositivos y el almacenamiento compatible con Amazon S3 en los dispositivos de la familia Snow. A continuación, utilice estas herramientas para configurar el dispositivo o el clúster Snowball Edge e iniciar el almacenamiento compatible con Amazon S3 en los dispositivos de la familia Snow.

Requisitos previos

El almacenamiento compatible con Amazon S3 en los dispositivos de la familia Snow requiere que tenga el cliente Snowball Edge AWS CLI instalado en su entorno local. También puede utilizar AWS SDK for .NET AWS Herramientas para Windows PowerShell para trabajar con el almacenamiento compatible con Amazon S3 en los dispositivos de la familia Snow. AWS recomienda utilizar las siguientes versiones de estas herramientas:

• Snowball Edge Client: utilice la versión más reciente. Para obtener más información, consulte Descarga e instalación del cliente de Snowball Edge en esta guía.

• AWS CLI— Versión 2.11.15 o posterior. Para obtener más información, consulte Instalación, actualización y desinstalación de AWS CLI en la Guía del AWS Command Line Interface usuario.

• AWS SDK for .NET— AWSSDK .S3Control 3.7.304.8 o posterior. Para obtener más información, consulte AWS SDK for .NET.

• AWS Herramientas para Windows PowerShell: versión 4.1.476 o posterior. Si quiere obtener más información, consulte la Guía del usuario de AWS Tools for Windows PowerShell.

Configuración del entorno local

En esta sección se describe cómo instalar y configurar el cliente Snowball Edge y su entorno local para su uso con el almacenamiento compatible con Amazon S3 en los dispositivos de la familia Snow.

1. Descargue e instale el cliente de Snowball Edge. Para obtener más información, consulte Descarga e instalación del cliente de Snowball Edge.

2. Configure un perfil para el cliente de Snowball Edge. Para obtener más información, consulte Configuración de un perfil para el cliente de Snowball Edge.

3. Si lo está utilizando AWS SDK for .NET, defina el valor del clientConfig.AuthenticationRegion parámetro de la siguiente manera:

   
     clientConfig.AuthenticationRegion = "snow"                        
                       

Configuración del dispositivo Snowball Edge

Configuración IAM en Snowball Edge

AWS Identity and Access Management (IAM) le ayuda a habilitar el acceso detallado a AWS los recursos que se ejecutan en sus dispositivos Snowball Edge. Se utiliza IAM para controlar quién está autenticado (ha iniciado sesión) y quién está autorizado (tiene permisos) para usar los recursos.

IAMse admite localmente en Snowball Edge. Puede utilizar el IAM servicio local para crear funciones y adjuntarles IAM políticas. Puede utilizar estas políticas para permitir el acceso necesario para realizar tareas asignadas.

El siguiente ejemplo permite el acceso total a Amazon S3API:

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

Para ver más ejemplos IAM de políticas, consulte la Guía para AWS Snowball Edge desarrolladores.

Inicio del servicio de almacenamiento compatible con Amazon S3 en dispositivos Snow Family

Siga las siguientes instrucciones para iniciar el servicio de almacenamiento compatible con Amazon S3 en dispositivos de la familia Snow en un dispositivo o clúster Snowball Edge.

Si prefiere una experiencia más fácil de usar, puede iniciar el servicio de almacenamiento en dispositivos de la familia Snow compatible con Amazon S3 para un dispositivo independiente o un clúster de dispositivos que lo utilice AWS OpsHub. Consulte Configure el almacenamiento compatible con Amazon S3 en los dispositivos de la familia Snow con AWS OpsHub.

1. Desbloquee el dispositivo o el clúster de dispositivos Snowball Edge ejecutando el siguiente comando:

   • Para un solo dispositivo:

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

   • Para un clúster:

     
      snowballEdge unlock-cluster

2. Ejecute el siguiente comando y asegúrese de que el dispositivo Snowball Edge o el clúster de dispositivos estén desbloqueados:

   • Para un solo dispositivo:

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

   • Para un clúster:

     
       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. En cada dispositivo (ya se trate de solo uno o de un clúster), para iniciar el almacenamiento compatible con Amazon S3 en dispositivos Snow Family, haga lo siguiente:

   1. Ejecute el siguiente comando describe-device para obtener el PhysicalNetworkInterfaceId del dispositivo:

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

   2. Ejecute el siguiente create-virtual-network-interface comando dos veces para crear las interfaces de red virtuales (VNIs) para los puntos finales s3control (para las operaciones de bucket) y s3api (para las operaciones con 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

      El comando devuelve una JSON estructura que incluye la dirección IP. Anote la dirección IP.

      Para obtener más información sobre estos comandos, consulte Configuración de una interfaz de red virtual (VNI) en un dispositivo de la familia Snow.

      nota

      El inicio del almacenamiento compatible con Amazon S3 en dispositivos Snow Family consume recursos de los dispositivos.

4. Inicie el servicio de almacenamiento compatible con Amazon S3 en dispositivos de la familia Snow ejecutando el start-service siguiente comando, que incluye las direcciones IP de sus dispositivos y los nombres de recursos de Amazon (ARNs) del VNIs que creó para los puntos s3api finales s3control y:

   Inicio del servicio en un solo 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

   Para iniciar el servicio en un clúster:

   
     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, incluya ARNs todo lo VNIs que creó en el paso anterior. Separe cada uno ARN mediante un espacio.

5. Ejecute el siguiente comando describe-service para un solo dispositivo:

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

   Espere hasta que el estado del servicio sea Active.

   Ejecute el siguiente comando describe-service para un clúster:

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

Visualización de información sobre el almacenamiento compatible con Amazon S3 en los puntos finales de los dispositivos de la familia Snow

Cuando se esté ejecutando el servicio de almacenamiento compatible con Amazon S3 en dispositivos de la familia Snow, puede utilizar el comando describe-service Snowball Edge Client para ver las direcciones IP asociadas a los puntos de conexión s3control y s3api.

snowballEdge describe-service --service-id s3-snow --endpoint https://snow-device-ip-address --profile profile-name

ejemplo salida del comando describe-service

En este ejemplo, la dirección IP del punto final s3control es 192.168.1.222 y la dirección IP del punto final s3api es 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"
      }
    }
  ]
}