Storage degli oggetti per l'infrastruttura Roving Edge

Il servizio di storage degli oggetti fornito da Oracle Cloud Infrastructure e Amazon S3 utilizza concetti e terminologia simili. In entrambi i casi, i dati vengono memorizzati come oggetti nei bucket. Le differenze sono nell'implementazione di funzionalità e strumenti per lavorare con gli oggetti.

Di seguito sono riportate le differenze tra le due tecnologie di storage:

• Compartimenti

  Amazon S3 non utilizza compartimenti. Per impostazione predefinita, i bucket creati mediante l'API di compatibilità Amazon S3 o l'API Swift vengono creati nel compartimento radice della tenancy Oracle Cloud Infrastructure. In alternativa, puoi designare un compartimento diverso per l'API di compatibilità Amazon S3 o l'API Swift in cui creare i bucket.

• Spazio di nomi bucket globale

  Lo storage degli oggetti non utilizza uno spazio di nomi bucket globale. Lo spazio di nomi funge invece da contenitore di livello superiore per tutti i gruppi e oggetti. In fase di creazione dell'account, a ogni tenant viene assegnato un nome di spazio dei nomi univoco e immutabile, generato dal sistema. Lo spazio dei nomi comprende tutti i compartimenti all'interno di un'area. È possibile controllare i nomi dei bucket, ma tali nomi devono essere univoci all'interno di uno spazio dei nomi. Mentre lo spazio dei nomi è specifico dell'area, il nome dello spazio dei nomi è lo stesso in tutte le aree. È possibile avere un bucket denominato MyBucket nell'area occidentale degli Stati Uniti (Phoenix) e un bucket denominato MyBucket nell'area centrale della Germania (Francoforte).

• Cifratura

  Per impostazione predefinita, il servizio di storage degli oggetti cifra tutti i dati in archivio. Impossibile attivare o disattivare la cifratura mediante l'API.

• ACL (Object Level Access Control List)

  Oracle Cloud Infrastructure non utilizza ACL per gli oggetti. Un amministratore deve invece impostare i gruppi , i compartimenti e i criteri che controllano quali utenti possono accedere a quali servizi, a quali risorse e al tipo di accesso. Ad esempio, i criteri controllano chi può creare utenti e gruppi, creare bucket, scaricare oggetti e gestire criteri e regole correlati allo storage degli oggetti.

Per ulteriori informazioni, vedere Panoramica dello storage degli oggetti.

Per abilitare l'accesso alle applicazioni da Amazon S3 allo storage degli oggetti, è necessario impostare l'accesso a Oracle Cloud Infrastructure e modificare l'applicazione.

1. Iscriviti a Oracle Cloud Infrastructure e ottieni uno spazio di nomi univoco.

2. Qualsiasi utente dell'API di compatibilità Amazon S3 con lo storage degli oggetti deve disporre dell'autorizzazione per utilizzare il servizio. Se non si è sicuri di avere l'autorizzazione, contattare l'amministratore. Per informazioni di base sui criteri, vedere funzionamento dei criteri. Per i criteri che consentono l'uso dello storage degli oggetti, vedere Criteri comuni e il riferimento ai criteri.

3. Utilizzare una chiave segreta cliente esistente o crearne una. Una chiave segreta del cliente è costituita da una coppia chiave di accesso/chiave segreta. La creazione e l'uso di queste chiavi sono descritte nella sezione seguente relativa all'impostazione del file di configurazione S3.

Lo storage degli oggetti sull'infrastruttura Roving Edge supporta lo strumento S3cmd di Amazon oltre a supportare l'interfaccia della riga di comando di Oracle Cloud Infrastructure. Il supporto dello strumento S3cmd di Amazon richiede la configurazione del file di configurazione S3, ma supporta anche S3cmd.

È possibile scaricare s3cmd dal seguente sito:

https://s3tools.org/download

Su Macintosh e Linux, il file di configurazione s3cmd si chiama .s3cfg e si trova nella directory home, ad esempio:

/home/username/($HOME)

In Windows, il file di configurazione s3cmd è denominato s3cmd.ini e si trova in %USERPROFILE% -> Application Data, che in genere è il seguente:

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

Per ulteriori informazioni, visitare il sito Web all'indirizzo: https://s3tools.org/kb/item14.htm

L'esempio seguente mostra il contenuto del file di configurazione 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 =

Per impostare il file di configurazione S3cmd da utilizzare con l'infrastruttura Roving Edge, procedere come segue.

1. Aggiornare il campo access_key:

   1. Eseguire il login alla console dei dispositivi dell'infrastruttura Roving Edge del dispositivo appropriato.

   2. Aprire il menu di navigazione e selezionare Identity Management > Utenti. Viene visualizzata la pagina Utenti. Tutti gli utenti sono elencati in formato tabulare.

   3. Selezionare l'utente di cui si desidera utilizzare la chiave di accesso nel file di configurazione S3cmd. Viene visualizzata la pagina Dettagli dell'utente.

   4. Selezionare Customer Secret Keys in Risorse. Viene visualizzata la pagina Chiavi segrete cliente. Tutte le chiavi segrete del cliente sono elencate in formato tabulare.

   5. Copiare la chiave di accesso e incollarla nel valore del campo access_key nel file di configurazione s3cmd.

2. Aggiornare il campo ca_certs_file: immettere il percorso completo del file bundle.pem, ad esempio:

   /Users/user_name/.oci/bundle.pem

   Se non si dispone del file di certificati ca, scaricarlo utilizzando il seguente comando:

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

3. Impostare il campo check_ssl_hostname su false.

4. Aggiornare il campo host_base: immettere il valore rover_node_IP:8019.

5. Aggiornare il campo host_bucket: immettere il valore rover_node_IP:8019.

6. Aggiornare il campo secret_key:

   1. Eseguire il login alla console dei dispositivi dell'infrastruttura Roving Edge del dispositivo appropriato.

   2. Aprire il menu di navigazione e selezionare Identity Management > Utenti. Viene visualizzata la sezione Utenti. Tutti gli utenti sono elencati in formato tabulare.

   3. Selezionare l'utente della cui chiave segreta si desidera utilizzare nel file di configurazione S3cmd. Viene visualizzata la pagina Dettagli dell'utente.

   4. Selezionare Customer Secret Keys in Risorse. Viene visualizzata la pagina Chiavi segrete cliente. Tutte le chiavi segrete del cliente sono elencate in formato tabulare.

   5. Selezionare Genera chiave segreta. La chiave segreta generata viene visualizzata nella finestra di dialogo Genera chiave segreta. Allo stesso tempo, Oracle genera il chiave di accesso abbinato alla chiave segreta. La nuova chiave segreta cliente generata viene aggiunta all'elenco di chiavi segrete cliente.

   6. Copiare la chiave e incollarla nel valore del campo secret_key nel file di configurazione s3cmd.

7. Salvare e chiudere il file di configurazione s3cmd.

Il supporto dell'API di compatibilità Amazon S3 viene fornito a livello di bucket e di oggetto.

API bucket

Sono supportate le seguenti API bucket:

• DeleteBucket
• HeadBucket
• GetService (elencare tutti i bucket personali)
• ListObjects
• PutBucket

API oggetto

Sono supportate le seguenti API oggetto:

• BulkDelete
• DeleteObject
• GetObject
• HeadObject
• PutObject

API di caricamento multiparte

Sono supportate le seguenti API di caricamento multiparte:

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

Utilizzando intestazioni API facoltative, puoi fornire la tua chiave di cifratura AES a 256 bit utilizzata per cifrare e decifrare gli oggetti caricati e scaricati dallo storage degli oggetti.

Se si desidera utilizzare le proprie chiavi per la cifratura lato server, specificare le tre intestazioni di richiesta riportate di seguito con le informazioni relative alle chiavi di cifratura.

Lo storage degli oggetti dispone di API distinte per copiare gli oggetti e copiare le parti. Amazon S3 utilizza la presenza delle seguenti intestazioni in PutObject e UploadPart per determinare le operazioni di copia. Per copiare un oggetto di origine cifrato con una chiave SSE-C, è necessario specificare queste tre intestazioni in modo che lo storage degli oggetti possa decifrare l'oggetto.

Utilizzando intestazioni API facoltative, puoi fornire la tua chiave di cifratura nel vault utilizzata per cifrare gli oggetti caricati nello storage degli oggetti.

Se si desidera utilizzare le proprie chiavi nel vault per la cifratura lato server, specificare l'intestazione di richiesta seguente con l'OCID della chiave nel vault:

Puoi configurare varie applicazioni client per comunicare con gli endpoint compatibili con Amazon S3 dello storage degli oggetti. In questo argomento vengono forniti alcuni esempi di configurazione per i client Amazon S3 supportati. Rivedere i prerequisiti in Impostazione dell'accesso a Oracle Cloud Infrastructure.

L'SDK AWS per il repository Java, il download di file e i collegamenti alla documentazione sono disponibili sul sito GitHub: https://github.com/aws/aws-sdk-java.

Ecco un esempio di configurazione dell'SDK AWS per Java per l'uso dello storage degli oggetti

                // 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