リソース・グループ内のツールチェーンへのアクセスの管理

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

アカウントで作成したツールチェーンは、デフォルトでは他のユーザーに表示されない場合があります。アカウント内のユーザーのリソース・グループのツールチェーンへのアクセスは、IBM CloudIdentity and Access Management (IAM) によって制御されます。アカウント内の新規ユーザーおよび既存ユーザーにアクセス権限を割り当てることができます。

Continuous Delivery サービス・インスタンスのユーザー・アクセスは、個別に管理されます。リソース・グループ内の Continuous Delivery サービス・インスタンスへのユーザー・アクセスの管理について詳しくは、Identity and Access Management を使用した Continuous Delivery ユーザー・アクセスの管理を参照してください。

ご使用のアカウント内のツールチェーンにアクセスするすべてのユーザーには、IAM アクセス・ポリシーを割り当てる必要があります。ポリシーによって、ユーザーがアクセスできるツールチェーンと、ユーザーが実行できるアクションが決まります。

ポリシーでは、さまざまなレベルまたは有効範囲のアクセス権限を付与できます。以下に例を示しますが、これらに限られるわけではありません。

アカウント内のすべてのツールチェーンに対するアクセス権限
アカウント内の特定のリソース・グループのすべてのツールチェーンに対するアクセス権限
アカウント内の特定のツールチェーンに対するアクセス権限

アクセス・ポリシーの有効範囲を定義した後に、役割を割り当てることができます。役割によって、ユーザーが実行できるアクションが決まります。次の表には、IAMプラットフォームのアクセスロールと、各ロールで利用可能なツールチェーンのアクションが一覧表示されています。

IAMプラットフォームの役割
プラットフォーム役割	アクションの説明	アクションの例
ビューアー	ツールチェーンおよびデリバリー・パイプラインを表示します。	ツールチェーンをクリックすると、その概要ページが開きます。
オペレーター	ツールチェーンおよびデリバリー・パイプラインを表示します。デリバリー・パイプラインを実行します。クライアント・カスタム・ツールチェーン・イベントを送信します。	ツールチェーンをクリックして、その「概要」ページを開きます。パイプラインジョブが属するステージの「ステージを実行」アイコンをクリックします。 POST /toolchains/{toolchain_id}/events API を呼び出します。
エディター、管理者	ツールチェーンおよびデリバリー・パイプラインの作成、表示、更新、および削除を行います。デリバリー・パイプラインを実行します。クライアント・カスタム・ツールチェーン・イベントを送信します。	IBM Cloudコンソールから、メニューアイコンの >Platform Automation>Toolchains* をクリックします。「ツールチェーン」ページで、「ツールチェーンを作成」をクリックします。 IBM Cloudコンソールから、メニューアイコンの >Platform Automation>Toolchains をクリックします。「ツールチェーン」ページで、削除するツールチェーンをクリックします。 [ アクション ] メニューをクリックし、[ 削除 ] を選択します。 IBM Cloudコンソールから、メニューアイコンの >Platform Automation>Toolchains をクリックします。「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。 [ツールの追加 ] をクリックし、追加したいツール連携を選択します。 IBM Cloud コンソールで、メニューアイコン（）をクリックし、「 Platform Automation 」を選択します。「パイプライン」ページで、「ステージ構成」アイコンをクリックし、続いて「ステージの構成」をクリックします。パイプラインジョブが属するステージの「ステージを実行」アイコンをクリックします。 POST{toolchain_id}APIを呼び出します。

次の表には、IAM サービスのアクセスロールと、各ロールで利用可能なアクションが一覧表示されています。

IAM サービス・アクセス・ロール
サービス役割	アクションの説明	アクションの例
EventSender	クライアント・カスタム・ツールチェーン・イベントを送信します。	POST /toolchains/{toolchain_id}/events API を呼び出します。
PipelineRunner	デリバリー・パイプラインを実行します。	パイプライン・ジョブがあるステージの「ステージの実行」アイコンをクリックします。

EventSender アクセスは、クライアント特注のツールチェーンイベントを送信する能力だけを与える。ツールチェーンに対して他のアクションを実行するには、ビューアー、オペレーター、エディター、管理者などの他の役割が必要です。

PipelineRunner アクセスは、配信パイプラインを実行する能力だけを与える。 UI からパイプラインを表示するには、ビューアー役割などの追加の役割が必要です。

以下の表に、ツールチェーンに対して実行可能なアクションとその説明を示します。

サービス・アクションとオペレーション
アクション	サービスに対する操作	役割
resource-controller.instance.create	リソース・グループ内にツールチェーンを作成します。	管理者、エディター
resource-controller.instance.update	リソース・グループ内のツールチェーンにバインドされているツールチェーンまたはツール統合を更新します。例えば、ツールチェーンの名前を変更します。リソース・グループ内のツールチェーンにバインドされているデリバリー・パイプラインを変更します。	管理者、エディター
resource-controller.instance.update_plan	適用外	管理者、エディター
resource-controller.instance.delete	リソース・グループからツールチェーンを削除します。	管理者、エディター
resource-controller.instance.retrieve	リソース・グループ内のツールチェーンにバインドされているツールチェーンまたはツール統合の詳細を表示します。	管理者、エディター、オペレーター、ビューアー
toolchain.event.send	クライアント・カスタム・ツールチェーン・イベントを送信します。	管理者、編集者、 EventSender, オペレーター
toolchain.instance.create-bindings	ツール統合をリソース・グループのツールチェーンに追加します。	管理者、エディター
toolchain.instance.delete-bindings	リソース・グループ内のツールチェーンからツール統合を削除します。	管理者、エディター
toolchain.instance.read-properties	将来の使用に備えて予約されています。	管理者、エディター、ビューアー
toolchain.instance.update-properties	将来の使用に備えて予約されています。	管理者、エディター
toolchain.pipeline-run.create	デリバリー・パイプラインを実行します。	管理者、編集者、オペレーター、 PipelineRunner

新規ユーザーへのアクセス権限の割り当て

新規ユーザーに、リソース・グループ内のすべてのツールチェーンに対するアクセス権限を割り当てることができます。

IBM Cloud コンソールで、[ 管理 ] をクリックし、> 「 Access (IAM) 」を選択し、「 ユーザー 」を選択します。
ユーザーの招待をクリックします。
招待するユーザーの E メール・アドレスを指定します。
「アクセス権限の割り当て方法」 セクションで、 「アクセス・ポリシー」 をクリックします。
「ツールチェーン」 サービスへのアクセス権限を割り当てることを選択します。
へのアクセス範囲を特定する 具体的なリソース。 「リソース・グループ」 属性タイプを選択し、リソース・グループを入力します。
[ リソースグループのアクセス ] セクションで、 [ビューアー （またはそれ以上の権限）] を選択します。これにより、ユーザーはプラットフォームからツールチェーン・サービス・インスタンスを表示したり、ツールチェーン・サービス・インスタンスの設定や運用に必要なプラットフォーム操作を実行したり、他のユーザーにアクセスポリシーを割り当てたりできるようになります。
「 ロールとアクション 」セクションで、「 エディター 」ロールを選択し、ユーザーがリソースグループからツールチェーンサービスを作成、表示、編集、または削除できる権限を付与します。 「ビューアー」 役割を選択して、ツールチェーンを表示するためのアクセス権限のみをユーザーに付与します。「 ビューア 」と PipelineRunner ロールを選択して、ユーザーにツールチェーンの表示やデリバリーパイプラインの実行権限を付与します。
追加をクリックします。
「招待」 をクリックします。

これで、新規ユーザーは、役割に応じて、指定されたリソース・グループ内のすべてのツールチェーンを使用できます。ツール統合を追加したり、パイプラインを変更および実行したりすることができます。

既存ユーザーへのアクセス権限の割り当て

既存のユーザーに、リソース・グループ内のツールチェーンに対するアクセス権限を割り当てることができます。

メニューバーから、「管理」＞をクリックします「 Access (IAM) 」を選択し、「 ユーザー 」を選択します。
アクセスを割り当てるユーザーの行から、「 アクション 」メニューを選択します。
「アクセス権限の割り当て」 をクリックします。
「アクセス権限の割り当て方法」 セクションで、 「アクセス・ポリシー」 をクリックします。
「ツールチェーン」 サービスへのアクセス権限を割り当てることを選択します。
へのアクセス範囲を特定する 具体的なリソース。 「リソース・グループ」 属性タイプを選択し、リソース・グループを入力します。
[ リソースグループのアクセス ] セクションで、 [ビューアー （またはそれ以上の権限）] を選択します。これにより、ユーザーはプラットフォームからツールチェーン・サービス・インスタンスを表示したり、ツールチェーン・サービス・インスタンスの設定や運用に必要なプラットフォーム操作を実行したり、他のユーザーにアクセスポリシーを割り当てたりできるようになります。
「 ロールとアクション 」セクションで、「 エディター 」ロールを選択し、ユーザーがリソースグループからツールチェーンサービスを作成、表示、編集、または削除できる権限を付与します。 「ビューアー」 役割を選択して、ツールチェーンを表示するためのアクセス権限のみをユーザーに付与します。「 ビューア 」と PipelineRunner ロールを選択して、ユーザーにツールチェーンの表示やデリバリーパイプラインの実行権限を付与します。
追加をクリックします。
割り当て をクリックします。

これで、このユーザーは、役割に応じて、指定されたリソース・グループ内のすべてのツールチェーンを使用できます。ツール統合を追加したり、パイプラインを変更および実行したりすることができます。

ここでは、ユーザーにアクセス権限を付与する方法として最も一般的で柔軟な方法を取り上げましたが、IAM では、リソースやリソース・タイプ、リソース・グループ別に付与するなどの他の方法も利用できます。ツールチェーンなどのリソースに対するアクセス権限をユーザーに割り当てる方法について詳しくは、リソースに対するアクセス権限の管理を参照してください。