Roving Edge Infrastructureのオブジェクト・ストレージ

Oracle Cloud InfrastructureおよびAmazon S3が提供するオブジェクト・ストレージ・サービスでは、同様の概念および用語が使用されています。どちらの場合も、データはバケット内のオブジェクトとして格納されます。相違点は、オブジェクトを操作するための機能およびツールの実装にあります。

次に、2つのストレージのテクノロジ間の相違点を示します:

• コンパートメント

  Amazon S3ではコンパートメントは使用されません。デフォルトでは、Amazon S3 Compatibility APIまたはSwift APIを使用して作成されたバケットは、Oracle Cloud Infrastructureテナンシのルート・コンパートメントに作成されます。かわりに、Amazon S3 Compatibility APIまたはSwift APIに異なるコンパートメントを指定して、バケットを作成できます。

• バケットのグローバル・ネームスペース

  オブジェクト・ストレージはグローバル・バケット・ネームスペースを使用しません。かわりに、ネームスペースは、すべてのバケットおよびオブジェクトの最上位のコンテナとして機能します。アカウント作成時に、システム生成および変更不可の一意のネームスペース名が各テナントに1つ割り当てられます。ネームスペースは、リージョン内のすべてのコンパートメントに適用されます。あなたはバケット名を制御します。ただし、それらのバケット名は1つのネームスペース内で一意である必要があります。ネームスペースはリージョン固有ですが、ネームスペース名自体はすべてのリージョンで同じです。米国西部(フェニックス)にMyBucketという名前のバケットと、ドイツ中央部(フランクフルト)にMyBucketという名前のバケットを持つことができます。

• 暗号化

  Object Storageサービスは、すべての保存データをデフォルトで暗号化します。APIを使用して暗号化を有効または無効にできません。

• オブジェクト・レベルのアクセス制御リスト(ACL)

  Oracle Cloud Infrastructureでは、オブジェクトにACLは使用されません。かわりに、管理者は、グループ、コンパートメントおよびポリシーを設定して、どのユーザーがどのサービスおよびリソースにアクセスできるか、およびアクセスのタイプを制御する必要があります。たとえば、ポリシーは、ユーザーとグループの作成、バケットの作成、オブジェクトのダウンロード、オブジェクト・ストレージ関連のポリシーとルールの管理などを実行できるユーザーを制御します。

詳細は、オブジェクト・ストレージの概要を参照してください。

Amazon S3からオブジェクト・ストレージへのアプリケーション・アクセスを有効にするには、Oracle Cloud Infrastructureへのアクセスを設定し、アプリケーションを変更する必要があります。

1. Oracle Cloud Infrastructureにサインアップして、一意のネームスペースを取得します。

2. Amazon S3 Compatibility APIとObject Storageのユーザーは、このサービスを操作する権限が必要です。権限があるかわからない場合は、管理者に連絡してください。ポリシーの基本情報は、ポリシーの動作を参照してください。オブジェクト・ストレージの使用を可能にするポリシーについては、共通ポリシーおよびポリシー・リファレンスを参照してください。

3. 既存の顧客秘密キーを使用するか、顧客秘密キーを作成します。顧客秘密キーはアクセス・キー/秘密キーのペアで構成されます。これらのキーの作成および使用については、S3構成ファイルの設定に関する次の項で説明します。

Roving Edge InfrastructureのObject Storageは、Oracle Cloud Infrastructureコマンドライン・インタフェースのサポートに加えて、Amazon S3cmdツールをサポートしています。Amazon S3cmdツールのサポートでは、S3構成ファイルを設定する必要がありますが、S3cmdもサポートしています。

s3cmdは、次のサイトからダウンロードできます。

https://s3tools.org/download

MacintoshおよびLinuxでは、s3cmd構成ファイルの名前は.s3cfgで、ホーム・ディレクトリにあります。次に例を示します。

/home/username/($HOME)

Windowsでは、s3cmd構成ファイルの名前はs3cmd.iniで、通常は%USERPROFILE% -> Application Dataにあります。

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

詳細は、https://s3tools.org/kb/item14.htmを参照してください。

次の例は、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 =

Roving Edge Infrastructureで使用するS3cmd構成ファイルを設定するには:

1. access_keyフィールドを更新します。

   1. 適切なデバイスのRoving Edge Infrastructureデバイス・コンソールにログインします。

   2. ナビゲーション・メニューを開き、「アイデンティティ管理」→「ユーザー」を選択します。ユーザー・ページが表示されます。すべてのユーザーが表形式でリストされます。

   3. S3cmd構成ファイルで使用するアクセス・キーを持つユーザーをクリックします。ユーザーの「詳細」ページが表示されます。

   4. 「リソース」で「顧客秘密キー」をクリックします。「顧客秘密キー」ページが表示されます。すべての顧客秘密キーが表形式でリストされます。

   5. アクセス・キーをコピーして、s3cmd構成ファイルのaccess_keyフィールド値に貼り付けます。

2. ca_certs_fileフィールドの更新: bundle.pemファイルのフルパスを入力します。たとえば:

   /Users/user_name/.oci/bundle.pem

   ca certsファイルがない場合は、次のコマンドを使用してダウンロードします。

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

3. check_ssl_hostnameフィールドをfalseに設定します。

4. host_baseフィールドの更新: rover_node_IP:8019を入力します。

5. host_bucketフィールドの更新: rover_node_IP:8019を入力します。

6. secret_keyフィールドを更新します。

   1. 適切なデバイスのRoving Edge Infrastructureデバイス・コンソールにログインします。

   2. ナビゲーション・メニューを開き、「アイデンティティ管理」→「ユーザー」を選択します。ユーザー・ページが表示されます。すべてのユーザーが表形式でリストされます。

   3. S3cmd構成ファイルで使用する秘密キーを持つユーザーをクリックします。ユーザーの「詳細」ページが表示されます。

   4. 「リソース」で「顧客秘密キー」をクリックします。「顧客秘密キー」ページが表示されます。すべての顧客秘密キーが表形式でリストされます。

   5. 「秘密キーの生成」をクリックします。生成された秘密キーが「秘密キーの生成」ダイアログ・ボックスに表示されます。同時に、Oracleは秘密キーとペアのアクセス・キーを生成します。新しく生成された顧客秘密キーが顧客秘密キーのリストに追加されます。

   6. キーをコピーして、s3cmd構成ファイルのsecret_keyフィールド値に貼り付けます。

7. s3cmd構成ファイルを保存して閉じます。

Amazon S3 Compatibility APIのサポートは、バケット・レベルおよびオブジェクト・レベルで提供されています。

バケットAPI

次のバケットAPIがサポートされています:

• DeleteBucket
• HeadBucket
• GetService (すべてのバケットをリスト)
• ListObjects
• PutBucket

オブジェクトAPI

次のオブジェクトAPIがサポートされています:

• BulkDelete
• DeleteObject
• GetObject
• HeadObject
• PutObject

マルチパート・アップロードAPI

次のマルチパート・アップロードAPIがサポートされています:

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

オプションのAPIヘッダーを使用すると、Object Storageとの間でアップロードおよびダウンロードされたオブジェクトの暗号化および暗号化に使用される独自の256ビットAES暗号化キーを指定できます。

サーバー側暗号化に独自のキーを使用する場合は、次の3つのリクエスト・ヘッダーを暗号化キー情報とともに指定します:

オブジェクト・ストレージには、オブジェクトやパートをコピーするための個別のAPIがあります。Amazon S3は、PutObjectおよびUploadPartに次のヘッダーが存在することを使用して、コピー操作を決定します。SSE-Cキーで暗号化されたソース・オブジェクトをコピーするには、オブジェクト・ストレージがオブジェクトを復号化できるように、これら3つのヘッダーを指定する必要があります。

オプションのAPIヘッダーを使用すると、Object Storageにアップロードされたオブジェクトの暗号化に使用される、Vault内の独自の暗号化キーを指定できます。

サーバー側暗号化にVault内の独自のキーを使用する場合は、次のリクエスト・ヘッダーをVault内のキーのOCIDで指定します:

様々なクライアント・アプリケーションを構成して、オブジェクト・ストレージのAmazon S3互換エンドポイントと通信できます。このトピックでは、サポートされているAmazon S3クライアントの構成例を示します。Oracle Cloud Infrastructureへのアクセスの設定の前提条件を確認します。

AWS SDK for Javaのリポジトリ、ファイルのダウンロードおよびドキュメントのリンクは、GitHub (https://github.com/aws/aws-sdk-java)にあります。

オブジェクト・ストレージを使用するようにAWS SDK for Javaを構成する例を次に示します。

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