Stockage d'objets pour l'infrastructure en périphérie de réseau Rover

Le service de stockage d'objets fourni par Oracle Cloud Infrastructure et Amazon S3 utilisent une terminologie et des concepts similaires. Dans les deux cas, les données sont stockées en tant qu'objets dans des seaux. Les différences résident dans la mise en oeuvre des fonctions et des outils relatifs à l'utilisation des objets.

Voici les différences entre les deux technologies de stockage :

• Compartiments

  Amazon S3 n'utilise pas de compartiment. Par défaut, les compartiments créés à l'aide de l'API de compatibilité Amazon S3 ou de l'API Swift sont créés dans le compartiment racine de la location Oracle Cloud Infrastructure. À la place, vous pouvez désigner un compartiment différent pour l'API de compatibilité Amazon S3 ou l'API Swift pour créer des seaux dedans.

• Espace de noms de seau global

  Le service de stockage d'objets n'utilise pas d'espace de noms de seau global. L'espace de noms sert plutôt de conteneur de niveau supérieur pour tous les seaux et objets. Lors de la création du compte, un nom d'espace de noms unique généré par le système et non modifiable est affecté à chaque locataire. L'espace de noms couvre tous les compartiments d'une région. Vous contrôlez les noms de seau, mais ceux-ci doivent être uniques au sein d'un espace de noms. Bien que l'espace de noms soit propre à une région, le nom de l'espace de noms lui-même est le même dans toutes les régions. Vous pouvez avoir un seau nommé MyBucket dans l'ouest des États-Unis (Phoenix) et un seau nommé MyBucket dans le centre de l'Allemagne (Francfort).

• Chiffrement

  Le service de stockage d'objets chiffre toutes les données au repos par défaut. Il n'est pas possible d'activer ou de désactiver le chiffrement à l'aide de l'API.

• Listes de contrôle d'accès au niveau de l'objet (LCA)

  Oracle Cloud Infrastructure n'utilise pas de LCA pour les objets. Au lieu de cela, un administrateur doit configurer les groupes , les compartiments et les politiques qui déterminent les utilisateurs pouvant accéder aux services et aux ressources, ainsi que le type d'accès. Par exemple, les politiques contrôlent qui peut créer des utilisateurs et des groupes, créer des seaux, télécharger des objets et gérer les politiques et les règles liées au stockage d'objets.

Pour plus d'informations, voir Aperçu du stockage d'objets.

Pour permettre à votre application d'accéder au stockage d'objets depuis Amazon S3 vous devez configurer l'accès à Oracle Cloud Infrastructure et modifier celui-ci.

1. Inscrivez-vous pour Oracle Cloud Infrastructure et obtenez un espace de noms unique.

2. Tout utilisateur de l'API de compatibilité Amazon S3 avec le service Stockage d'objets doit disposer de l'autorisation nécessaire pour utiliser le service. Si vous n'êtes pas sûr de disposer de l'autorisation nécessaire, communiquez avec l'administrateur. Pour des informations de base sur les politiques, voir Comment fonctionnent les politiques. Pour les politiques qui permettent d'utiliser le service de stockage d'objets, voir Politiques communes et Référence liée aux politiques.

3. Utilisez une clé secrète de client existante ou en créer une. Une clé secrète de client est associée à une paire clé d'accès/clé secrète. La création et l'utilisation de ces clés sont décrites dans la section suivante sur la configuration du fichier de configuration S3.

Le service de stockage d'objets sur le service d'infrastructure en périphérie de réseau Rover prend en charge l'outil Amazon S3cmd en plus de prendre en charge l'interface de ligne de commande Oracle Cloud Infrastructure. La prise en charge de l'outil Amazon S3cmd nécessite que vous configuriez le fichier de configuration S3, mais prend également en charge S3cmd.

Vous pouvez télécharger s3cmd à partir du site suivant :

https://s3tools.org/download

Sur Macintosh et Linux, le fichier de configuration s3cmd est nommé .s3cfg et se trouve dans votre répertoire de base, par exemple :

/home/username/($HOME)

Sous Windows, le fichier de configuration s3cmd est nommé s3cmd.ini et se trouve dans %USERPROFILE% -> Application Data, qui est généralement le suivant :

c:\users\username\AppData\Roaming\s3cmd.ini

Pour plus de détails, consultez la page https://s3tools.org/kb/item14.htm

L'exemple suivant présente le contenu du fichier de configuration S3cmd :

[default]
access_key = 9aa40ec9-bec3-4fab-9e5a-3584a5979d48
access_token =
add_encoding_exts =
add_headers =
bucket_location = US
cache_file =
ca_certs_file = <Full path to the bundle.pem file>
check_ssl_hostname = False
default_mime_type = binary/octet-stream
delay_updates = False
delete_after = False
delete_after_fetch = False
delete_removed = False
dry_run = False
enable_multipart = True
encoding = UTF-8
encrypt = False
expiry_date =
expiry_days =
expiry_prefix =
follow_symlinks = False
force = False
get_continue = False
gpg_command = /usr/bin/gpg
gpg_decrypt = %(gpg_command)s -d --verbose --no-use-agent --batch --yes --passphrase-fd %(passphrase_fd)s -o %(output_file)s %(input_file)s
gpg_encrypt = %(gpg_command)s -c --verbose --no-use-agent --batch --yes --passphrase-fd %(passphrase_fd)s -o %(output_file)s %(input_file)s
gpg_passphrase =
guess_mime_type = True
host_base = <rover_node_ip>:8019
host_bucket = <rover_node_ip>:8019
human_readable_sizes = False
ignore_failed_copy = False
invalidate_default_index_on_cf = False
invalidate_default_index_root_on_cf = True
invalidate_on_cf = False
list_md5 = False
log_target_prefix =
max_delete = -1
mime_type =
multipart_chunk_size_mb = 15
preserve_attrs = True
progress_meter = True
proxy_host =
proxy_port = 0
put_continue = False
recursive = False
recv_chunk = 4096
reduced_redundancy = False
restore_days = 1
secret_key = <Your secret key, see below>
send_chunk = 4096
server_side_encryption = False
skip_existing = False
socket_timeout = 300
urlencoding_mode = normal
use_https = True
use_mime_magic = True
verbosity = WARNING
website_endpoint = https://<rover_node_ip>:8015
website_error =

Pour configurer le fichier de configuration S3cmd à utiliser avec l'infrastructure en périphérie de réseau Rover :

1. Mettez à jour le champ access_key :

   1. Connectez-vous à la console d'appareil du service d'infrastructure en périphérie de réseau Rover de l'appareil approprié.

   2. Ouvrez le menu de navigation et sélectionnez Gestion des identités > Utilisateurs. La page Utilisateurs s'affiche. Tous les utilisateurs sont présentés sous forme de tableau.

   3. Sélectionnez l'utilisateur dont vous voulez utiliser la clé d'accès dans le fichier de configuration S3cmd. La page Détails de l'utilisateur s'affiche.

   4. Sélectionnez Clés secrètes de client sous Ressources. La page Clés secrètes de client s'affiche. Toutes les clés secrètes de client sont présentées sous forme de tableau.

   5. Copiez la clé d'accès et passez-la dans la valeur du champ access_key dans le fichier de configuration s3cmd.

2. Mettez à jour le champ ca_certs_file : Entrez le chemin complet de votre fichier bundle.pem, par exemple :

   /Users/user_name/.oci/bundle.pem

   Si vous ne disposez pas du fichier ca certs, téléchargez-le à l'aide de la commande suivante :

   echo -n | openssl s_client -showcerts -connect rover_node_IP:8015 | 
   sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > bundle.pem

3. Réglez le champ check_ssl_hostname à false.

4. Mettez à jour le champ host_base : Entrez rover_node_IP:8019.

5. Mettez à jour le champ host_bucket : Entrez rover_node_IP:8019.

6. Mettez à jour le champ secret_key :

   1. Connectez-vous à la console d'appareil du service d'infrastructure en périphérie de réseau Rover de l'appareil approprié.

   2. Ouvrez le menu de navigation et sélectionnez Gestion des identités > Utilisateurs. La page Utilisateurs s'affiche. Tous les utilisateurs sont présentés sous forme de tableau.

   3. Sélectionnez l'utilisateur dont vous voulez utiliser la clé secrète dans le fichier de configuration S3cmd. La page Détails de l'utilisateur s'affiche.

   4. Sélectionnez Clés secrètes de client sous Ressources. La page Clés secrètes de client s'affiche. Toutes les clés secrètes de client sont présentées sous forme de tableau.

   5. Sélectionnez Générer une clé secrète. Le champ Clé secrète généré est affiché dans la boîte de dialogue Créer une clé secrète. En même temps, Oracle génère la clé d'accès qui est associée à la clé secrète. La clé secrète de client nouvellement générée est ajoutée à la liste des clés secrètes de client.

   6. Copiez la clé et passez-la dans la valeur du champ secret_key dans le fichier de configuration s3cmd.

7. Enregistrez et fermez le fichier de configuration s3cmd.

La prise en charge de l'API de compatibilité Amazon S3 est fournie au niveau de compartiment et au niveau de l'objet.

API de seau

Les API de seau suivantes sont prises en charge :

• DeleteBucket
• HeadBucket
• GetService (lister tous mes seaux)
• ListObjects
• PutBucket

API d'objet

Les API d'objet suivantes sont prises en charge :

• BulkDelete
• DeleteObject
• GetObject
• HeadObject
• PutObject

API de chargement en plusieurs parties

Les API de chargement en plusieurs parties suivantes sont prises en charge :

• AbortMultipartUpload
• CompleteMultipartUpload
• InitiateMultipartUpload
• ListParts
• ListUploads
• UploadPart

À l'aide des en-têtes d'API facultatifs, vous pouvez fournir votre propre clé de chiffrement AES 256 bits qui est utilisée pour chiffrer et déchiffrer les objets chargés et téléchargés à partir du stockage d'objets.

Si vous voulez utiliser vos propres clés pour le chiffrement côté serveur, spécifiez les trois en-têtes de demande suivants avec les informations sur la clé de chiffrement :

Le service de stockage d'objets offre des API distinctes pour la copie d'objets et la copie de parties. Amazon S3 utilise la présence des en-têtes suivants dans PutObject et UploadPart pour déterminer les opérations de copie. Pour copier un objet source crypté avec une clé SSE-C, vous devez spécifier ces trois en-têtes afin que le stockage d'objets puisse décrypter l'objet.

À l'aide des en-têtes d'API facultatifs, vous pouvez fournir votre propre clé de chiffrement dans le service de chambre forte qui est utilisée pour chiffrer les objets chargés dans le service de stockage d'objets.

Si vous voulez utiliser vos propres clés dans le service de chambre forte pour le chiffrement côté serveur, spécifiez l'en-tête de demande suivant avec l'OCID de la clé dans le service de chambre forte :

Vous pouvez configurer diverses applications clients pour qu'elles communiquent avec les points d'extrémité compatibles avec Amazon S3 du service de stockage d'objets. Cette rubrique fournit des exemples de configuration pour les clients Amazon S3 pris en charge. Vérifiez les préalables dans Configuration de l'accès à Oracle Cloud Infrastructure.

La trousse SDK AWS pour le référentiel Java, le téléchargement de fichiers et les liens vers la documentation sont disponibles sur GitHub : https://github.com/aws/aws-sdk-java.

Voici un exemple de configuration de la trousse SDK AWS pour que Java utilise le stockage d'objets

                // Put the Access Key and Secret Key here
                
AWSCredentialsProvider credentials = new AWSStaticCredentialsProvider(new BasicAWSCredentials(
 "gQ4+YC530sBa8qZI6WcbUbtH8oar0exampleuniqueID",
 "7fa22331ebe62bf4605dc9a42aaeexampleuniqueID"))));

// Your namespace
String namespace = "rover-namespace";

// The region to connect to
String region = "us-ashburn-1";

// Create an S3 client pointing at the region
String endpoint = String.format("%s.compat.objectstorage.%s.oraclecloud.com",namespace,region);
AwsClientBuilder.EndpointConfiguration endpointConfiguration = new AwsClientBuilder.EndpointConfiguration(endpoint, region);
AmazonS3 client = AmazonS3Client.builder()
 .standard()
 .withCredentials(credentials)
 .withEndpointConfiguration(endpointConfiguration)
 .disableChunkedEncoding()
 .enablePathStyleAccess()
 .build();

s3 = new AWS.S3({
  region: 'us-ashburn-1',
  endpoint: 'https://' + rover-namespace + '.compat.objectstorage.us-ashburn-1.oraclecloud.com',
  accessKeyId: 'gQ4+YC530sBa8qZI6WcbUbtH8oar0exampleuniqueID',
  secretAccessKey: '7fa22331ebe62bf4605dc9a42aaeexampleuniqueID',
  s3ForcePathStyle: true,
  signatureVersion: 'v4',
});

import boto3
  
s3 = boto3.resource(
    's3',
    aws_access_key_id="gQ4+YC530sBa8qZI6WcbUbtH8oar0exampleuniqueID",
    aws_secret_access_key="7fa22331ebe62bf4605dc9a42aaeexampleuniqueID",
    region_name="us-phoenix-1", # Region name here that matches the endpoint
    endpoint_url="https://rover-namespace.compat.objectstorage.us-phoenix-1.oraclecloud.com" # Include your rover-namespace in the URL
)
  
# Print out the bucket names
for bucket in s3.buckets.all():
    print bucket.name

umount /path/to/local_directory_name