アーティファクト・レジストリへのアーティファクトのアップロード

アーティファクトをアーティファクト・レジストリにアップロードするために使用するメソッドは、アーティファクト・ファイルのサイズによって異なります。

ファイル・サイズは200MB未満です
  • Oracle Cloudコンソール(推奨)
  • クラウド・シェルでのOCI CLI
  • ローカル環境でのOCI CLI
  • REST API
ファイル・サイズ200MBから4 GB
  • クラウド・シェルOCI CLI (推奨)
  • ローカル環境でのOCI CLI
  • REST API
4 GBより大きいファイル・サイズ
  • ローカル環境でのOCI CLI (推奨)
  • REST API
ヒント

アーティファクト・ファイル・サイズが200MBを超える場合は、コンソールを使用してそのアーティファクトをアップロードできませんが、CLIコマンドをコピーしてコンソールからそのアーティファクトをアップロードできます。生成されたCLIコマンドを取得するには、コンソールでアーティファクトをアップロードするための次のステップを参照してください。

    1. ナビゲーション・メニューを開き、「開発者サービス」をクリックします。「コンテナとアーティファクト」で、「アーティファクト・レジストリ」をクリックします。
    2. 「List」スコープで、アーティファクトのリポジトリを含むコンパートメントを選択します。
    3. アーティファクトのリポジトリの名前をクリックします。
    4. 「アーティファクトのアップロード」をクリックします。
    5. 新しいアーティファクトに対して、アーティファクト・パスを指定します。このパスは、アーティファクトの場所を示します。アーティファクト・パスは、文字、スラッシュまたはアンダースコアで始まり、その後に文字、数字、ダッシュ、スラッシュまたはアンダースコアを続けることができます。スラッシュはディレクトリ構造を作成しませんが、スラッシュを使用してリポジトリを編成できます。例:

      • project01/my-test-app/test-artifact
      • project01/my-web-app/artifact-abc
    6. 新しいアーティファクトに対して、Versionの文字列を指定します。アーティファクトには増分更新が加えられるため、アーティファクトにバージョンを割り当てます。こうすると、ビルドをアーティファクトのバージョンに関連付けて、以前のバージョンにロールバックできます。例:

      • 1.1.0
      • 1.2-beta-2

      パスとバージョンを入力すると、アーティファクト名に次の書式が移入されます:

      <artifact-path>:<version>

    7. 200MB未満のファイルをアップロードするには、「コンソール」をクリックし、次のステップに従います:
      1. アーティファクトを選択するか、「コンテンツ・ファイル」領域にドラッグします。
      2. 「アップロード」をクリックします。
    8. 200MBから4 GBの間のファイルをアップロードするには、「クラウド・シェル」をクリックし、次のステップに従います:
      1. クラウド・シェルを起動します。
      2. アーティファクトをクラウド・シェル・ウィンドウにドラッグします。
      3. ファイル転送が完了したら、「アーティファクトのアップロード」ウィンドウに表示された生成されたコマンドをコピーして、クラウド・シェルにコマンドを貼り付けます。
      4. <file-name>を、Cloud Shellにドラッグしたファイルの名前に更新します。
      5. クラウド・シェルでコマンドを実行します。
      6. 「アーティファクトのアップロード」ウィンドウを閉じます。
      7. コマンドがCloud Shellで正常に実行されたら、ブラウザをリフレッシュして、リストされたアーティファクトを表示します。
    9. 4を超えるGBのファイルをアップロードするには、「CLI」をクリックし、次のステップに従います:
      1. ローカル環境でOCI CLIを設定します。一般的な情報については、CLIを使用する方法を参照してください。インストール手順については、CLIのクイックスタートを参照してください。
      2. 「アーティファクトのアップロード」ウィンドウに表示された生成されたコマンドをコピーし、ローカル環境にコマンドを貼り付けます。
      3. コマンドで、ローカル環境のアーティファクトへのパスを指定して<path-to-file>を更新します。例:

        ./artifact-abc.zip
      4. ローカル環境でコマンドを実行します。
  • アーティファクト・レジストリのコマンドライン・リファレンスを使用して、アーティファクト・レジストリ・リポジトリにアーティファクトをアップロードします。

    アーティファクト・レジストリのリポジトリにアーティファクトをアップロードするには、artifacts generic artifactリソースを使用します。

    artifacts generic artifactのすべてのコマンドを取得します:

    oci artifacts generic artifact -h

    upload-by-pathコマンドのヘルプを取得します:

    oci artifacts generic artifact upload-by-path -h

    必須のオプションを見つけます:

    • --repository-id
    • --artifact-path (リポジトリのアーティファクトを整理するためのユーザー定義パス)
    • --artifact-version (ユーザー定義バージョン)
    • --content-body (ローカル環境のアーティファクトへのパス)

    アーティファクトをアップロードします:

    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>

    例:

    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>
  • PutGenericArtifactContentByPath操作を使用して、特定のリポジトリのアーティファクトをアップロードします。