Configuration et démarrage du stockage compatible Amazon S3 sur les appareils Snow Family

Installez et configurez des outils logiciels depuis AWS votre environnement local pour interagir avec l'appareil ou le cluster d'appareils Snowball Edge et le stockage compatible Amazon S3 sur les appareils de la gamme Snow. Utilisez ensuite ces outils pour configurer l'appareil ou le cluster Snowball Edge et démarrer le stockage compatible Amazon S3 sur les appareils de la gamme Snow.

Prérequis

Le stockage compatible avec Amazon S3 sur les appareils de la gamme Snow nécessite que le client Snowball Edge soit AWS CLI installé dans votre environnement local. Vous pouvez également utiliser AWS SDK for .NET et AWS Tools for Windows PowerShell pour utiliser le stockage compatible Amazon S3 sur les appareils de la gamme Snow. AWS recommande d'utiliser les versions suivantes de ces outils :

• Snowball Edge Client : utilisez la dernière version. Pour plus d'informations, consultez la section Téléchargement et installation du client Snowball Edge dans ce guide.

• AWS CLI— Version 2.11.15 ou ultérieure. Pour plus d'informations, consultez la section Installation, mise à jour et désinstallation du AWS CLI dans le guide de l' AWS Command Line Interface utilisateur.

• AWS SDK for .NET— AWSSDK .S3Control 3.7.304.8 ou version ultérieure. Pour de plus amples informations, veuillez consulter AWS SDK for .NET.

• AWS Outils pour Windows PowerShell — Version 4.1.476 ou ultérieure. Pour plus d’informations, consultez le AWS Tools for Windows PowerShell guide de l’utilisateur.

Configuration de votre environnement local

Cette section explique comment configurer le client Snowball Edge et votre environnement local pour une utilisation avec le stockage compatible Amazon S3 sur les appareils de la gamme Snow.

1. Téléchargez et installez le client Snowball Edge. Pour plus d'informations, voir Téléchargement et installation du client Snowball Edge.

2. Configurez un profil pour le client Snowball Edge. Pour plus d'informations, voir Configuration d'un profil pour le client Snowball Edge.

3. Si vous utilisez AWS SDK for .NET, définissez la valeur du clientConfig.AuthenticationRegion paramètre comme suit :

   
     clientConfig.AuthenticationRegion = "snow"                        
                       

Configuration de votre appareil Snowball Edge

Configuration IAM sur le Snowball Edge

AWS Identity and Access Management (IAM) vous aide à permettre un accès granulaire aux AWS ressources qui s'exécutent sur vos appareils Snowball Edge. Vous pouvez IAM contrôler qui est authentifié (connecté) et autorisé (autorisé) à utiliser les ressources.

IAMest pris en charge localement sur le Snowball Edge. Vous pouvez utiliser le IAM service local pour créer des rôles et leur associer des IAM politiques. Vous pouvez utiliser ces stratégies pour autoriser l'accès nécessaire à l'exécution des tâches assignées.

L'exemple suivant permet un accès complet à Amazon S3 API :

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

Pour plus d'exemples IAM de politiques, consultez le guide du AWS Snowball Edge développeur.

Démarrage du service de stockage compatible Amazon S3 sur les appareils Snow Family

Suivez les instructions suivantes pour démarrer le service de stockage compatible Amazon S3 sur les appareils de la famille Snow sur un appareil ou un cluster Snowball Edge.

Si vous préférez une expérience plus conviviale, vous pouvez démarrer le service de stockage compatible Amazon S3 sur les appareils de la famille Snow pour un appareil autonome ou un cluster d'appareils utilisant AWS OpsHub. Consultez Configurez le stockage compatible Amazon S3 sur les appareils Snow Family avec AWS OpsHub.

1. Déverrouillez votre appareil ou groupe d'appareils Snowball Edge en exécutant la commande suivante :

   • Pour un seul appareil :

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

   • Pour un cluster :

     
      snowballEdge unlock-cluster

2. Exécutez la commande suivante et assurez-vous que le périphérique ou le groupe d'appareils Snowball Edge est déverrouillé :

   • Pour un seul appareil :

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

   • Pour un 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. Pour chaque appareil (que vous en possédiez un ou un cluster), pour démarrer un stockage compatible avec Amazon S3 sur les appareils de la gamme Snow, procédez comme suit :

   1. Récupérez l'appareil PhysicalNetworkInterfaceId en exécutant la describe-device commande suivante :

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

   2. Exécutez deux fois la create-virtual-network-interface commande suivante pour créer les interfaces réseau virtuelles (VNIs) pour les points de terminaison s3control (pour les opérations sur les compartiments) et s3api (pour les opérations sur les objets).

      
        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

      La commande renvoie une JSON structure qui inclut l'adresse IP. Notez cette adresse IP.

      Pour plus de détails sur ces commandes, voir Configuration d'une interface réseau virtuelle (VNI) sur un appareil de la gamme Snow.

      Note

      Le démarrage d'un stockage compatible Amazon S3 sur les appareils Snow Family consomme les ressources de l'appareil.

4. Démarrez le service de stockage compatible Amazon S3 sur les appareils de la famille Snow en exécutant la start-service commande suivante, qui inclut les adresses IP de vos appareils et les Amazon Resource Names (ARNs) des appareils VNIs que vous avez créés pour les points de s3api terminaison s3control et :

   Pour démarrer le service sur un seul appareil :

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

   Pour démarrer le service sur un 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

   Pour--virtual-network-interface-arns, incluez ARNs pour tout VNIs ce que vous avez créé à l'étape précédente. Séparez chacune ARN d'entre elles par un espace.

5. Exécutez la describe-service commande suivante pour un seul appareil :

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

   Attendez que l'état du service soit rétabliActive.

   Exécutez la describe-service commande suivante pour un cluster :

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

Affichage des informations relatives au stockage compatible Amazon S3 sur les terminaux des appareils de la gamme Snow

Lorsque le service de stockage compatible Amazon S3 sur les appareils de la famille Snow est en cours d'exécution, vous pouvez utiliser la commande describe-service Snowball Edge Client pour afficher les adresses IP associées aux points de terminaison s3control et s3api.

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

Exemple sortie de describe-service commande

Dans cet exemple, l'adresse IP du point de terminaison s3control est 192.168.1.222 et l'adresse IP du point de terminaison s3api est 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"
      }
    }
  ]
}