Configura copia per memorizzazione degli oggetti

Puoi utilizzare Rclone con l'API di storage degli oggetti OCI nativa per eseguire la migrazione dei dati nei bucket di storage degli oggetti OCI. Tieni presente un bucket di migrazione di destinazione oppure consulta l'esercitazione Metti i dati nello storage degli oggetti per scoprire come creare un bucket di OCI Object Storage.

I primi passi includono il recupero delle credenziali appropriate e dell'endpoint API. Questa soluzione utilizzerà Rclone su un host Linux e l'autenticazione con un utente OCI e una chiave API. Per ulteriori metodi di autorizzazione e informazioni su come scaricare e installare Rclone, consultare la documentazione di Rclone Oracle Object Storage.

Nota

Per le risorse di cui sopra, vedere "Esplora di più", in altre parti di questa guida, per i collegamenti appropriati.

Impostare l'autenticazione con un utente OCI e una chiave API, ottenere lo spazio di nomi della tenancy OCI e il compartimento bucket

Generare una coppia di firma API, impostare un file di configurazione e ottenere lo spazio di nomi della tenancy, le informazioni sul compartimento e l'endpoint API di storage degli oggetti regionale.

Per prima cosa, genera una coppia di chiavi di firma API:
1. Visualizzare i dettagli dell'utente.
  - Se si sta creando una chiave API per se stessi, aprire il menu Profilo (icona del menu utente) e fare clic su Impostazioni utente.
  - Se si è amministratori che creano una chiave API per un altro utente, nella console fare clic su Identità, quindi su Utenti. Per visualizzare i dettagli, individuare l'utente nella lista, quindi fare clic sul nome dell'utente.
2. Sul lato sinistro della pagina nella sezione Risorse, fare clic su Chiavi API.
3. Fare clic su Aggiungi chiave API.
4. Fare clic su Aggiungi chiave API nella parte superiore sinistra della lista Chiavi API. Viene visualizzata la finestra di dialogo Add API Key.
5. Fare clic su Scarica chiave privata e salvare la chiave nella directory .oci. Nella maggior parte dei casi, non è necessario scaricare la chiave pubblica.
  Nota
  - Se non si dispone di una directory .oci, crearne una nella directory home
  - Se il browser scarica la chiave privata in un'altra directory, spostarla nella directory .oci
  .
6. Fare clic su Aggiungi.
  La chiave viene aggiunta alle risorse dell'utente OCI e viene visualizzata l'anteprima file di configurazione. Si noti che il profilo è contrassegnato come DEFAULT; sarà necessario il nome del profilo in seguito durante l'impostazione della configurazione Rclone. Copiare e incollare lo snippet del file di configurazione dalla casella di testo in un file in un file denominato config nella directory .oci. Aggiornare il percorso key_file nel file di configurazione in modo che corrisponda alla posizione nel passo e, sopra riportato. Salvare il percorso del file per impostare la configurazione Rclone.
Ottenere la stringa dello spazio di nomi dello storage degli oggetti:
1. Aprire il menu Profilo e fare clic su Tenancy: <your_tenancy_name>. La stringa dello spazio di nomi viene elencata in Impostazioni dello storage degli oggetti.
2. Copiare la stringa dello spazio di nomi, in quanto sarà necessario durante l'impostazione di Rclone.
Determinare il compartimento e l'area del bucket:
1. Nella console OCI passare a Storage, Storage degli oggetti e storage di archivio, quindi a Bucket e trovare il nome del bucket in cui verrà eseguita la migrazione dei dati.
2. Fare clic sul nome del bucket per visualizzare i dettagli.
3. Cerca nell'angolo in alto a sinistra della pagina OCI Console e annota l'area in cui si trova il bucket e il nome dell'area. Queste informazioni saranno necessarie durante l'impostazione di Rclone.
4. Fare clic sul collegamento del nome accanto al compartimento per visualizzare i dettagli del compartimento.
5. Nella pagina dei dettagli del compartimento, cercare nella scheda Informazioni compartimento e copiare l'OCID compartimento. Avrai bisogno di queste informazioni durante l'impostazione di Rclone,

Configurare Rclone per Storage degli oggetti OCI

Successivamente, devi configurare Rclone per OCI Object Storage. Seguire la procedura descritta di seguito.

Passare al sistema Linux ed eseguire rclone config per avviare un processo di impostazione interattivo:

$ rclone config
No remotes found, make a new one?
e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q>

Selezionare l'opzione n) New remote e, quando richiesto, immettere un nome per il nuovo telecomando:
```
Enter name for new remote.
<enter your name here>
```
Il prompt successivo richiede il tipo di memorizzazione e presenterà un elenco di opzioni. Selezionare il numero associato a OCI Object Storage (oracleobjectstorage):
```
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
.
.
.
35 / OpenStack Swift (Rackspace Cloud Files, Blomp Cloud Storage, Memset Memstore, OVH)
   \ (swift)
36 / Oracle Cloud Infrastructure Object Storage
   \ (oracleobjectstorage)
37 / Pcloud
   \ (pcloud)
<snip>
Storage> 36
```
Nota
A partire da questo articolo, l'opzione è il numero 36. Questo numero cambia con le release di Rclone quando aggiungono ulteriori opzioni di archiviazione. Assicurarsi di verificare che si stia selezionando l'opzione di menu per Storage degli oggetti OCI.

Selezionare il provider di autenticazione che si desidera utilizzare. In questo esempio, verrà selezionata l'opzione 2 OCI user and API Key:

Option provider.
Choose your Auth Provider
Choose a number from below, or type in your own string value.
Press Enter for the default (env_auth).
 1 / automatically pickup the credentials from runtime(env), first one to provide auth wins
   \ (env_auth)
   / use an OCI user and an API key for authentication.
 2 | you’ll need to put in a config file your tenancy OCID, user OCID, region, the path, fingerprint to an API key.
   | https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdkconfig.htm
   \ (user_principal_auth)
   / use instance principals to authorize an instance to make API calls.
 3 | each instance has its own identity, and authenticates using the certificates that are read from instance metadata.
   | https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/callingservicesfrominstances.htm
   \ (instance_principal_auth)
   / use workload identity to grant OCI Container Engine for Kubernetes workloads policy-driven access to OCI resources using OCI Identity and Access Management (IAM).
 4 | https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contenggrantingworkloadaccesstoresources.htm
   \ (workload_identity_auth)
 5 / use resource principals to make API calls
   \ (resource_principal_auth)
 6 / no credentials needed, this is typically for reading public buckets
   \ (no_auth)
provider> 2

Immettere lo spazio di nomi dello storage degli oggetti della tenancy OCI, creato e registrato quando è stato eseguito il passo 2b in "Impostazione dell'autenticazione con un utente OCI e una chiave API, Ottenere lo spazio di nomi della tenancy OCI e il compartimento bucket"):
```
Option namespace.
Object storage namespace
Enter a value.
namespace> namespace_name
```
Immettere l'OCID del compartimento del bucket (creato e registrato quando è stato eseguito il passo 3e in "Impostazione dell'autenticazione con un utente e una chiave API OCI, Ottenere lo spazio di nomi della tenancy OCI e il compartimento del bucket"):
```
Option compartment.
Object storage compartment OCID
Enter a value.
compartment> ocid1.compartment.oc1xxx.xxxx.xxxx.xxxx
```
Immettere l'area del bucket (creata e registrata quando è stato eseguito il passo 3c in "Impostazione dell'autenticazione con un utente e una chiave API OCI, Ottenere lo spazio di nomi della tenancy OCI e il compartimento bucket"):
```
Option region.
Object storage Region
Enter a value.
region> us-ashburn-1
```
Il prompt successivo riguarda l'endpoint. Lasciare vuoto il campo che consente di selezionare l'endpoint dell'area predefinito. Rclone utilizzerà le informazioni raccolte per formare l'URL completo dell'endpoint:
```
Option endpoint.
Endpoint for Object storage API.
Leave blank to use the default endpoint for the region.
Enter a value. Press Enter to leave empty.
endpoint>
```

Immettere il percorso completo della posizione del file di configurazione OCI e le informazioni config_profile (create e registrate quando è stato eseguito il passo 1f in "Impostazione dell'autenticazione con un utente e una chiave API OCI, Ottenere lo spazio di nomi della tenancy OCI e il compartimento bucket"), rispondere n per la configurazione avanzata:

Option config_file.
Path to OCI config file
Choose a number from below, or type in your own string value.
Press Enter for the default (~/.oci/config).
 1 / oci configuration file location
   \ (~/.oci/config)
config_file> /home/username/.oci/config
 
Option config_profile.
Profile name inside the oci config file
Choose a number from below, or type in your own string value.
Press Enter for the default (Default).
 1 / Use the default profile
   \ (Default)
config_profile> DEFAULT
 
Edit advanced config?
y) Yes
n) No (default)
y/n> n

Se tutto sembra corretto, Rclone visualizzerà un riepilogo per la configurazione, selezionare y per salvare la configurazione:


Options:
- type: oracleobjectstorage
- provider: user_principal_auth
- namespace: namespace
- compartment: ocid1.compartment.oc1xxx.xxxx.xxxx.xxxx
- region: us-ashburn-1
- config_file: /home/username/.oci/config
- config_profile: DEFAULT
Keep this "foo" remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
 
Current remotes:
 
Name                 Type
====                 ====
remote_name          oracleobjectstorage

Uscire dall'interfaccia di configurazione:

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q

Eseguire il test della connessione Rclone elencando i bucket nel compartimento:
```
$ rclone lsd remote_name:
          -1 2024-04-19 00:08:33        -1 bucket1
```