クラウドの設定 Object Storage

DevOps Insights 2026年8月31 日にサービス終了となり、提供が中止されます。 Continuous Delivery は、2027年2月12日に以下のリージョンで提供が中止されます： au-syd、 ca-tor、 us-east。 また、同日をもって、Code Risk Analyzerもすべての地域で提供を終了いたします。 あるリージョンでこれらの機能が実際に利用されていない場合、そのリージョンにおける機能は早期に提供終了となり、新規インスタンスの受け入れが停止される可能性があります。 詳細はこちら

IBM Cloud® Object Storage は、大量のデータを安全に保管し、コンプライアンスを確保し、コストを最適化するために使用されます。 IBM Cloud Object Storage Bucketを統合して証拠を保存することができます。 このツール統合は、ツールチェーンの特定のストレージ要件に使用することもできます。

前提条件

ツールチェインとCloud Object Storage Bucketを統合する前に、以下のステップを完了していることを確認してください。

  1. ツールチェインにCloud Object Storage Bucketツールを追加するには、Cloud Object Storage、Bucketインスタンスが必要です。

  2. Cloud Object Storage Bucket を認証するには、API Key または HMAC Key を使用できます。 要件に応じて、適切な 認証 方法を選択する必要があります。

  3. Service credentials タブで、Cloud Secrets Manager インスタンスの サービス認証情報を作成する ことを選択できます。

  4. Secrets Manager インスタンスを作成して、先に作成したサービス・クレデンシャルを保存することができる。 Secret Manager ツールをツールチェーンと統合し、 Secrets Manager インスタンスと、以前に作成されたシークレットをこの統合にポイントします。

ツールチェーンの証拠やその他の成果物を安全に保存し、アクセスするには、Cloud Object Storage Bucketを設定します：

  1. ツールチェーンの作成中にこのツールの統合を設定しており、設定中のテンプレート内に「Cloud Object Storage 」バケットが存在する場合は、「Cloud Object Storage 」バケットタブをクリックしてください。 または、 More tools セクションでCloud Object Storage Bucketをクリックする。

  2. ツールチェーンをお持ちで、これにこのツールの統合を追加する場合は、コンソール IBM Cloud からハンバーガーアイコン > プラットフォーム自動化 > ツールチェーンをクリックします。 「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。

    a. 追加 をクリックします。

    b. [ツールの統合] セクションで、[ Cloud Object Storage バケット ] をクリックします。

  3. Cloud Object Storage Bucket の統合を識別するための Name を入力します。

  4. 要件に応じて認証タイプを選択します。 認証に API Key を使用している場合は、 Cloud Object Storage API Key と Cloud Object Storage インスタンスを指定してください。 認証に HMAC を使用する場合は、HMAC のアクセス・キー ID とシークレット・ アクセス・キーを指定する。 Cloud Object Storage インスタンスに対して、これらの認証方法の両方のサービス認証情報を作成することができます。 これらの値はリテラルとして直接参照することができる。 しかし、これらのシークレットが保存されている Secrets Manager。 その後、これらの秘密を秘密ストアから選択して認証することができる。

  5. 対応するクラウド Object Storage インスタンスに定義されているバケット名と エンドポイントを入力します。

  6. 「統合の作成」 をクリックします。

APIを使用したクラウド Object Storage バケットの設定

IBM Cloud Object Storage Bucket ツール統合では、ツール統合 を作成、 読み取り、 更新するときに ツールチェーン HTTP API および SDK で使用できる次の構成パラメータがサポートされています。

リクエスト・ボディの tool_type_id プロパティには、 cloudobjectstorage 値を指定する必要があります。

IBM Cloud Object Storage バケットツール統合パラメータ
パラメーター 使用法 タイプ 説明
name 必須、更新可能 ストリング このツール統合を識別するために使用される名前。
auth_type 必須、更新可能 ストリング 認証タイプ。 IBM Cloud API Key の場合は apikey を、HMAC (Hash Message Authentication Code)の場合は hmac を渡す。
cos_api_key 必須、更新可能 ストリング apikey として auth_type の場合、クラウド Object Storage インスタンスまたは instance_crn へのアクセスを認証するために cos_api_key を渡す。
instance_crn 必須、更新可能 ストリング 既存のクラウド Object Storage インスタンスへの参照。
bucket_name 必須、更新可能 ストリング Cloud Object Storage バケットの名前。
hmac_access_key_id 必須、更新可能 パスワード HMAC鍵に対して定義されたHMACアクセス鍵。 HMACは、アクセス・キーIDとシークレット・アクセス・キーの組み合わせで識別される。 クラウド Object Storage インスタンスに関連付けられている。
hmac_secret_access_key 必須、更新可能 パスワード HMAC鍵に定義された秘密のアクセス鍵。 HMACは、アクセス・キーIDとシークレット・アクセス・キーの組み合わせで識別される。 クラウド Object Storage インスタンスに関連付けられている。
endpoint 必須、更新可能 ストリング Cloud Object Storage インスタンス用に定義されたエンドポイント。 オプションは public, direct、 private