Almacenamiento de objetos para Roving Edge Infrastructure

El servicio Object Storage proporcionado por Oracle Cloud Infrastructure y Amazon S3 utilizan conceptos y terminología similares. En ambos casos, los datos se almacenan como objetos en cubos. Las diferencias se encuentran en la implementación de funciones y herramientas para trabajar con objetos.

A continuación, se destacan las diferencias entre las dos tecnologías de almacenamiento:

• Compartimentos

  Amazon S3 no utiliza compartimentos. Por defecto, los cubos creados mediante la API de compatibilidad de Amazon S3 o la API de Swift se crean en el compartimento raíz del arrendamiento de Oracle Cloud Infrastructure. En su lugar, puede designar un compartimento diferente para que la API de compatibilidad de Amazon S3 o la API de Swift creen cubos en él.

• Espacio de nombres de cubo global

  Object Storage no utiliza un espacio de nombres de cubo global. En su lugar, el espacio de nombres sirve como contenedor de nivel superior para todos los cubos y objetos. Durante la creación de la cuenta, a cada inquilino se le asigna un nombre de espacio de nombre inmutable, generado por el sistema y único. El espacio de nombre abarca todos los compartimentos dentro de una región. Puede controlar los nombres de cubo, pero esos nombres de cubo deben ser únicos dentro de un espacio de nombre. Aunque el espacio de nombre es específico de la región, el espacio de nombre en sí es el mismo en todas las regiones. Puede tener un cubo denominado MyBucket en el oeste de EE. UU. (Phoenix) y un cubo denominado MyBucket en el centro de Alemania (Fráncfort).

• Cifrado

  El servicio Object Storage cifra todos los datos en reposo por defecto. El cifrado no se puede activar ni desactivar mediante la API.

• Listas de control de acceso de nivel de objeto (ACL)

  Oracle Cloud Infrastructure no utiliza ACL para objetos. En su lugar, un administrador debe configurar grupos , compartimentos y políticas que controlen qué usuarios pueden acceder a qué servicios, qué recursos y el tipo de acceso. Por ejemplo, las políticas controlan quién puede crear usuarios y grupos, crear cubos, descargar objetos y gestionar reglas y políticas relacionadas con Object Storage.

Para obtener más información, consulte Descripción general de Object Storage.

Para permitir el acceso a la aplicación desde Amazon S3 a Object Storage, debe configurar el acceso a Oracle Cloud Infrastructure y modificar la aplicación.

1. Regístrese en Oracle Cloud Infrastructure y obtenga un espacio de nombres único.

2. Cualquier usuario de la API de compatibilidad de Amazon S3 con Object Storage necesita permiso para trabajar con el servicio. Si no está seguro de si tiene permiso, póngase en contacto con el administrador. Para obtener más información sobre las políticas, consulte Cómo funcionan las políticas. Para conocer las políticas que permiten el uso de Object Storage, consulte Políticas comunes y la Referencia de políticas.

3. Utilice una clave secreta de cliente existente. Una clave secreta de cliente consta del par clave de acceso/clave secreta. La creación y el uso de estas claves se describen en la siguiente sección sobre la configuración del archivo de configuración S3.

Object Storage en Roving Edge Infrastructure admite la herramienta S3cmd de Amazon, además de admitir la interfaz de línea de comandos de Oracle Cloud Infrastructure. El soporte de la herramienta S3cmd de Amazon requiere que configure el archivo de configuración S3, pero también admite S3cmd.

s3cmd se puede descargar del siguiente sitio:

https://s3tools.org/download

En Macintosh y Linux, el archivo de configuración s3cmd se denomina .s3cfg y se encuentra en el directorio raíz, por ejemplo:

/home/username/($HOME)

En Windows, el archivo de configuración s3cmd se denomina s3cmd.ini y se encuentra en %USERPROFILE% -> Application Data, que normalmente es el siguiente:

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

Para obtener más información, consulte: https://s3tools.org/kb/item14.htm

En el siguiente ejemplo se muestra el contenido del archivo de configuración 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 =

Para configurar el archivo de configuración S3cmd para su uso con Roving Edge Infrastructure:

1. Actualice el campo access_key:

   1. Inicie sesión en la consola de dispositivos de Roving Edge Infrastructure del dispositivo adecuado.

   2. Abra el menú de navegación y seleccione Gestión de identidad > Usuarios. Aparecerá la página Usuarios. Todos los usuarios se muestran en formato tabular.

   3. Haga clic en el usuario cuya clave de acceso desea utilizar en el archivo de configuración S3cmd. Aparece la página Detalles del usuario.

   4. Haga clic en Claves secretas de cliente en Recursos. Aparecerá la página Claves secretas de cliente. Todas las claves secretas de cliente se muestran en formato tabular.

   5. Copie la clave de acceso y péguela en el valor del campo access_key del archivo de configuración s3cmd.

2. Actualice el campo ca_certs_file: introduzca la ruta de acceso completa del archivo bundle.pem, por ejemplo:

   /Users/user_name/.oci/bundle.pem

   Si no tiene el archivo ca certs, descárguelo con el siguiente comando:

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

3. Defina el campo check_ssl_hostname en false.

4. Actualice el campo host_base: introduzca rover_node_IP:8019.

5. Actualice el campo host_bucket: introduzca rover_node_IP:8019.

6. Actualice el campo secret_key:

   1. Inicie sesión en la consola de dispositivos de Roving Edge Infrastructure del dispositivo adecuado.

   2. Abra el menú de navegación y seleccione Gestión de identidad > Usuarios. Aparece la página Usuarios. Todos los usuarios se muestran en formato tabular.

   3. Haga clic en el usuario cuya clave secreta desea utilizar en el archivo de configuración S3cmd. Aparece la página Detalles del usuario.

   4. Haga clic en Claves secretas de cliente en Recursos. Aparecerá la página Claves secretas de cliente. Todas las claves secretas de cliente se muestran en formato tabular.

   5. Haga clic en Generar clave secreta. La Clave secreta generada se mostrará en el cuadro de diálogo Generar clave secreta. Al mismo tiempo, Oracle genera la Clave de acceso que está emparejada con la Clave secreta. La clave secreta de cliente recién generada se agregará a la lista Claves secretas de cliente.

   6. Copie la clave y péguela en el valor del campo secret_key en el archivo de configuración s3cmd.

7. Guardar y cerrar el archivo de configuración s3cmd.

El soporte de la API de compatibilidad de Amazon S3 se proporciona en el nivel de cubo y en el nivel de objeto.

API de cubo

Se admiten las siguientes API de cubo:

• DeleteBucket
• HeadBucket
• GetService (muestra todos los cubos)
• ListObjects
• PutBucket

API de objeto

Se admiten las siguientes API de objeto:

• BulkDelete
• DeleteObject
• GetObject
• HeadObject
• PutObject

API de carga de varias partes

Se admiten las siguientes API de carga de varias partes:

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

Con las cabeceras de API opcionales, puede proporcionar su propia clave de cifrado AES de 256 bits que se utiliza para cifrar y descifrar objetos cargados y descargados en Object Storage.

Si desea utilizar sus propias claves para el cifrado de servidor, especifique las tres cabeceras de solicitud siguientes con la información de clave de cifrado:

El almacenamiento de objetos tiene API distintas para copiar objetos y copiar partes. Amazon S3 utiliza la presencia de las siguientes cabeceras en PutObject y UploadPart para determinar las operaciones de copia. Para copiar un objeto de origen cifrado con una clave SSE-C, debe especificar estas tres cabeceras para que Object Storage pueda descifrar el objeto.

Con las cabecera de API opcionales, puede proporcionar su propia clave de cifrado en Vault, que se utiliza para cifrar los objetos cargados en Object Storage.

Si desea utilizar sus propias claves en Vault para el cifrado de servidor, especifique la siguiente cabecera de solicitud con el OCID de la clave de Vault:

Puede configurar varias aplicaciones cliente para comunicarse con los puntos finales compatibles con Amazon S3 de Object Storage. En este tema se proporcionan algunos ejemplos de configuración para clientes de Amazon S3 soportados. Revise los requisitos en Configuración de acceso a Oracle Cloud Infrastructure.

El SDK de AWS para el repositorio de Java, la descarga de archivos y los enlaces de documentación están disponibles en GitHub: https://github.com/aws/aws-sdk-java.

A continuación se muestra un ejemplo de configuración del SDK de AWS para Java para utilizar Object Storage

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