Git Repos and Issue Tracking の構成

ツールの統合は Git Repos and Issue Tracking ツールの統合は、 Git リポジトリ（レポ）のウェブベースのホスティングサービスである GitLab Community Edition をベースにしている。リポジトリーのローカルとリモートの両方のコピーを持つことができます。詳しくは、 Git Repos and Issue Trackingを参照してください。

ツールチェーンの作成時に Git Repos and Issue Tracking を構成する場合は、以下の手順に従います。

「構成可能な統合」セクションで**「Git Repos and Issue Tracking」**をクリックします。
Git リポジトリーのデフォルト・ターゲット・ロケーションを確認します。これらのリポジトリーは、サンプル・リポジトリーのクローンです。必要に応じて、ターゲット・リポジトリーの名前を変更します。

ツールチェーンがあり、そのツールチェーン内の Git リポジトリーを Git Repos and Issue Tracking に移行する場合は、以下のステップを実行します。

ここで説明する手順は、Git Repos and Issue Tracking に移行する Git リポジトリーが既に含まれているツールチェーンに適用されます。ツールチェーンにさまざまなタイプの Git リポジトリーを追加する方法については、GitHub の構成およびGitLab の構成を参照してください。

IBM Cloudコンソールから、メニューアイコンの >Platform Automation>Toolchains をクリックします。「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。あるいは、アプリの「概要」ページの「継続的デリバリー」カードで、**「ツールチェーンの表示」をクリックします。次に、「概要」**をクリックします。
追加をクリックします。
「ツール統合」セクションで**「Git Repos and Issue Tracking」**をクリックします。
コード変更のデプロイ先にするサーバーを選択します。統合の作成後には、自分が作業する権限のあるサーバーのリストを管理するために、それを編集することができます。 **「許可の管理」**をクリックして、すべてのサーバーのリストを表示したり、サーバーに関して許可を与えるために提供したトークンを削除したりできます。
Git リポジトリーのコピーを作成する場合は、リポジトリーのタイプとして**「クローンを作成する (Clone)」**をクリックします。新規リポジトリー名と、ソース・リポジトリーの URL を入力します。
この新しい統合の所有権を自分に割り当てるために、自分のユーザー名が自動的に選択されます。統合が作成された後には、別の許可ユーザーが編集するときに、統合の所有権をそのユーザー自身に再割り当てすることができます。
プライベート・リポジトリーを作成する場合には、**「このリポジトリーをプライベートにする (Make this repository private)」**チェック・ボックスを選択します。
問題のトラッキングに Issues を使用する場合は、**「Issues を使用可能にする (Enable Issues)」**チェック・ボックスにチェック・マークを付けます。
コミットに対するタグおよびコメントと、コミットで参照される問題に対するラベルおよびコメントを作成することによって、コード変更のデプロイメントをトラッキングしたい場合は、**「コード変更のデプロイメントを追跡する (Track deployment of code changes)」**チェック・ボックスにチェック・マークを付けます。コード・デプロイメントのトラッキングについて詳しくは、 Track where your code is deployed with toolchainsを参照してください。
「統合の作成」 をクリックします。

Git リポジトリーのクローンを作成したら、ツールチェーンから削除できます。

既存のツールチェーンに Git Repos and Issue Tracking を追加する場合は、以下の手順に従います。

IBM Cloudコンソールから、メニューアイコンの >Platform Automation>Toolchains をクリックします。「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。あるいは、アプリの「概要」ページの「継続的デリバリー」カードで、**「ツールチェーンの表示」をクリックします。次に、「概要」**をクリックします。
**「ツールの追加」**をクリックします。
「ツール統合」セクションで**「Git Repos and Issue Tracking」**をクリックします。
コード変更のデプロイ先にするサーバーを選択します。統合の作成後には、自分が作業する権限のあるサーバーのリストを管理するために、それを編集することができます。 **「許可の管理」**をクリックして、すべてのサーバーのリストを表示したり、サーバーに関して許可を与えるために提供したトークンを削除したりできます。
リポジトリー・タイプを選択します。

a. 空のリポジトリーを作成する場合は、リポジトリーのタイプとして**「新規 (New)」をクリックし、リポジトリー名を入力します。 b. マージ・リクエストを通して変更内容を提供できるように Git リポジトリーをフォークする場合は、リポジトリーのタイプとして「フォーク (Fork)」をクリックします。ソース・リポジトリーの URL を入力します。 c. Git リポジトリーのコピーを作成する場合は、リポジトリーのタイプとして「クローンを作成する (Clone)」をクリックします。新規リポジトリー名と、ソース・リポジトリーの URL を入力します。 d. 既存の Git リポジトリーを使用する場合は、リポジトリーのタイプとして「既存」**をクリックします。ソース・リポジトリーの URL を入力します。
この新しい統合の所有権を自分に割り当てるために、自分のユーザー名が自動的に選択されます。統合が作成された後には、別の許可ユーザーが編集するときに、統合の所有権をそのユーザー自身に再割り当てすることができます。
プライベート・リポジトリーを作成する場合には、**「このリポジトリーをプライベートにする (Make this repository private)」**チェック・ボックスを選択します。
問題のトラッキングに Issues を使用する場合は、**「Issues を使用可能にする (Enable Issues)」**チェック・ボックスにチェック・マークを付けます。
コミットに対するタグおよびコメントと、コミットで参照される問題に対するラベルおよびコメントを作成することによって、コード変更のデプロイメントをトラッキングしたい場合は、**「コード変更のデプロイメントを追跡する (Track deployment of code changes)」**チェック・ボックスにチェック・マークを付けます。詳しくは、ツールチェーンでコードがどこにデプロイされたかを追跡するを参照のこと。
「統合の作成」 をクリックします。
ツールチェーンの「概要」ページの**「リポジトリー」**カードで、処理する Git リポジトリーをクリックします。プロジェクト概要のページが開きます。

リンクしようとしているリポジトリーに対する Master または Owner 特権をお持ちでない場合、Web フックを使用できないので統合は制限されます。リポジトリーにコミットがプッシュされたときにパイプラインが自動的に実行されるようにするには、Web フックが必要です。 Web フックがない場合、パイプラインを手動で開始する必要があります。

API を使って Git Repos and Issue Tracking を設定する

Git Repos and Issue Tracking ツール統合は、ツール統合を作成、読み込み、更新する際に、 Toolchain HTTP API および SDK で使用できる以下の構成パラメータをサポートしています。

hostedgit 値を使用して、要求本体に tool_type_id プロパティーを指定する必要があります。

Git Repos and Issue Trackingツール統合パラメータ
パラメーター	使用法	タイプ	Terraform 引数	説明
API のルート URL	オプション、更新可能	ストリング	API のルート URL	Git Repos and Issue Tracking APIの URL。
API トークン	オプション、更新可能	パスワード	API トークン	パーソナル・アクセストークン（PAT）。このパラメーターは、 `auth_type` が `pat` に設定されている場合にのみ必要です。それ以外の場合は無視されます。
auth_type	オプション、更新可能、 `Default: oauth`	ストリング	auth_type	Git プロバイダーへのアクセスに使用する認証方式を設定します。
デフォルト・ブランチ	オプション、更新可能	ストリング	デフォルト・ブランチ	Git リポジトリーのデフォルト・ブランチの名前です。
enable_traceability	オプション、更新可能、 `Default: false`	ブール値	enable_traceability	この値を `true` に設定すると、コミット、プルリクエスト、参照された課題にタグ、ラベル、コメントを作成して、コード変更のデプロイを追跡します。
Git_id	オプション、不変	ストリング	Git_id	Git Repos and Issue Trackingをターゲットにするには、この値を `hostedgit` に設定します。
has_issues	オプション、更新可能、 `Default: true`	ブール値	ツールチェーンの発行が有効	Git Repos and Issue Tracking リポジトリーで問題を有効にし、問題ツール統合カードをツールチェーンに追加するには、この値を `true` に設定します。ツールチェーンからツール統合カードを削除するには、この値を `false` に設定します。このアクションは、 Git Repos and Issue Tracking リポジトリー自体で問題が有効になっているかどうかには影響しません。
統合所有者	オプション、更新可能	ストリング	統合所有者	Git 操作を実行するユーザーを選択します。
owner_id	オプション、不変	ストリング	owner_id	リポジトリーを所有する Git Repos and Issue Tracking のユーザーまたはグループ。このパラメーターは、リポジトリーを作成する場合、またはリポジトリーを複製またはフォークする場合に必要です。この値は、既存のリポジトリーにリンクすると計算されます。
プライベート・リポジトリー	オプション、不変、 `Default: true`	ブール値	プライベート・リポジトリー	リポジトリーを作成するとき、またはリポジトリーを複製またはフォークするときに、リポジトリーをプライベートにするには、この値を `true` に設定します。既存のリポジトリーにリンクする場合、このパラメーターは使用されません。
リポジトリー ID	オプション、不変	ストリング	リポジトリー ID	Git Repos and Issue Tracking プロジェクトのID。
repo_name	オプション、不変	ストリング	repo_name	作成する Git Repos and Issue Tracking リポジトリの名前。このパラメーターは、リポジトリーを作成する場合、またはリポジトリーを複製またはフォークする場合に必要です。この値は、既存のリポジトリーにリンクしたときに計算されます。
repo_url	オプション、不変	ストリング	repo_url	このツール統合のための Git Repos and Issue Tracking リポジトリの URL。既存のリポジトリーにリンクする場合、このパラメーターは必須です。この値は、リポジトリーを作成するとき、またはリポジトリーを複製またはフォークするときに計算されます。
ソース repo_URL	オプション、不変	ストリング	ソース repo_URL	フォークまたはクローンしたいリポジトリの URL。このパラメーターは、リポジトリーをフォークまたはクローン作成するときには必須ですが、リポジトリーまたは既存のリポジトリーへのリンクを作成するときには使用されません。
トークン URL	オプション、更新可能	ストリング	トークン URL	Git Repos and Issue Tracking サーバとの認証に使用されるトークン URL。
タイプ	必須、変更不可能	ストリング	タイプ	新規ツール統合を初期化するために実行する操作。 `new` を使用して Git リポジトリーを作成します。 `clone` を使用して既存の Git リポジトリーを新しい Git リポジトリーに複製したり、 `fork` を使用して既存の Git リポジトリーをフォークしたり、 `link` を使用して既存の Git リポジトリーにリンクしたりします。

Trusted Profile を使用して IBM Cloud にログインしている場合は、 Git Repos and Issue Tracking ツール統合を構成する際に、Personal Access Token 認証方法を使用する必要があります。 OAuth認証方式は、Trusted Profiles.The Personal Access Token (PAT)認証と互換性がないため、GUI、API、Terraformのいずれかを使用して、 Git Repos and Issue Tracking ツールの統合を設定することができます。これは、PATが信頼されたプロファイルを所有する実際のユーザーと結びついているからである。ユーザーはパーソナル・アクセストークンを使用して、 Git Repos and Issue Tracking ツール統合をツールチェーンで作成または再設定することができます。ただし、実際の Git リポジトリのUIにアクセスするには、通常のユーザーとしてログインする必要がある。