Documentazione di Oracle Cloud Infrastructure

Caricamento di un artifact nel registro artifact

Il metodo utilizzato per caricare un artifact nel registro artifact dipende dalla dimensione del file artifact.

Dimensione file minore di 200 MB
  • Oracle Cloud Console (consigliato)
  • CLI OCI in Cloud Shell
  • CLI OCI in un ambiente locale
  • API REST
Dimensione file da 200 MB a 4 GB
  • CLI OCI in Cloud Shell (consigliato)
  • CLI OCI in un ambiente locale
  • API REST
Dimensione del file maggiore di 4 GB
  • CLI OCI in un ambiente locale (consigliato)
  • API REST
Suggerimento

Se la dimensione di un file artifact è maggiore di 200 MB, non è possibile utilizzare la console per caricare l'artifact, ma è possibile copiare il comando CLI per caricare l'artifact dalla console. Per ottenere un comando CLI generato, vedere la procedura riportata di seguito per caricare un artifact nella console.

    1. Aprire il menu di navigazione e fare clic su Servizi per sviluppatori. In Container e artifact fare clic su Registro artifact.
    2. In Ambito elenco, scegliere un compartimento contenente un repository per gli artifact.
    3. Fare clic sul nome di un repository per gli artifact.
    4. Fare clic su Carica artifact.
    5. Per il nuovo artifact, specificare un percorso artifact. Questo percorso descrive la posizione dell'artifact. Un percorso artifact può iniziare con una lettera, una barra o un carattere di sottolineatura, seguito da lettere, numeri, lineette, barre o caratteri di sottolineatura. Le barre non creano una struttura di directory, ma è possibile utilizzare le barre per organizzare un repository. Esempio:

      • project01/my-test-app/test-artifact
      • project01/my-web-app/artifact-abc
    6. Per il nuovo artifact, specificare una stringa per la versione. A causa degli aggiornamenti incrementali negli artifact, è possibile assegnare versioni agli artifact. In questo modo, è possibile associare le build alle versioni dell'artifact ed eseguire il rollback alle versioni precedenti. Esempio:

      • 1.1.0
      • 1.2-beta-2

      Quando si immettono il percorso e la versione, il nome dell'artifact viene popolato con il formato seguente:

      <artifact-path>:<version>

    7. Per caricare un file di dimensioni inferiori a 200 MB, fare clic su Console e attenersi alla procedura riportata di seguito.
      1. Selezionare o trascinare un artifact nell'area File di contenuto.
      2. Fare clic su Carica.
    8. Per caricare un file con dimensioni comprese tra 200 MB e 4 GB, fare clic su Cloud Shell e attenersi alla procedura riportata di seguito.
      1. Avvia Cloud Shell.
      2. Trascinare un artifact nella finestra Cloud Shell.
      3. Al termine del trasferimento del file, copiare il comando generato visualizzato nella finestra Carica artifact e incollare il comando in Cloud Shell.
      4. Aggiornare <file-name> al nome del file trascinato in Cloud Shell.
      5. Eseguire il comando in Cloud Shell.
      6. Chiudere la finestra Carica artifact.
      7. Dopo aver eseguito correttamente il comando in Cloud Shell, aggiornare il browser per visualizzare l'artifact elencato.
    9. Per caricare un file di dimensioni superiori a 4 GB, fare clic su CLI e attenersi alla procedura riportata di seguito.
      1. Impostare l'interfaccia CLI OCI in un ambiente locale. Per informazioni generali, vedere How do I use the CLI? e per i passi di installazione vedere il Quickstart dell'interfaccia CLI.
      2. Copiare il comando generato visualizzato nella finestra Carica artifact e incollare il comando nell'ambiente locale.
      3. Aggiornare <path-to-file> nel comando con il percorso dell'artifact nell'ambiente locale. Esempio:

        ./artifact-abc.zip
      4. Eseguire il comando in un ambiente locale.

  • Caricare gli artifact nei repository del registro artifact utilizzando il riferimento riga di comando per il registro artifact.

    Per caricare un artifact in un repository in Registro artifact, utilizzare la risorsa artifacts generic artifact.

    Ottenere tutti i comandi per artifacts generic artifact:

    oci artifacts generic artifact -h

    Consultare la Guida per il comando upload-by-path:

    oci artifacts generic artifact upload-by-path -h

    Trovare le opzioni obbligatorie:

    • --repository-id
    • --artifact-path (percorso definito dall'utente per organizzare l'artifact nel repository)
    • --artifact-version (versione definita dall'utente)
    • --content-body (percorso dell'artifact nell'ambiente locale)

    Carica un artifact:

    oci artifacts generic artifact upload-by-path --repository-id <repository-OCID> --artifact-path <user-defined-path-for-artifact> --artifact-version <version> --content-body <path-to-artifact-on-local-env>

    Esempio:

    oci artifacts generic artifact upload-by-path --repository-id ocid1.artifactrepository.oc1..xxx... --artifact-path project01/my-web-app/artifact-abc --artifact-version 1.0 --content-body <path-to-artifact-on-local-env>

  • Utilizzare l'operazione PutGenericArtifactContentByPath per caricare un artifact in un repository specifico.