Code Stream には、GitHub、GitLab、または Bitbucket リポジトリでコード変更が発生したときにパイプラインをトリガする方法が用意されています。Git トリガは、監視するリポジトリのブランチにある Git エンドポイントを使用します。 Code Stream は、Webhook を介して Git エンドポイントに接続します。

Code Stream で Git エンドポイントを定義するには、プロジェクトを選択し、エンドポイントを配置する Git リポジトリのブランチを入力します。プロジェクトでは、エンドポイントやその他の関連オブジェクトとパイプラインがグループ化されます。Webhook の定義でプロジェクトを選択するときに、トリガするエンドポイントとパイプラインを選択します。
注: エンドポイントを使用して Webhook を定義し、後でエンドポイントを編集する場合、Webhook のエンドポイントの詳細を変更することはできません。エンドポイントの詳細を変更するには、Webhook を削除し、そのエンドポイントを使用して再定義する必要があります。 Code Streamで Git トリガを使用してパイプラインを実行する方法を参照してください。

前提条件

  • 接続する予定の GitHub、GitLab、または Bitbucket リポジトリにアクセスできることを確認します。
  • オンプレミスの Git リポジトリを使用する場合は、クラウド プロキシを追加するために VMware Cloud Assembly にアクセスできることを確認します。例については、リリース プロセスをモデリングするための VMware Code Stream の設定を参照してください。
  • Code Streamで、プロジェクトのメンバーであることを確認します。メンバーでない場合は、プロジェクトにメンバーとして追加するように Code Stream管理者に依頼します。VMware Code Streamでプロジェクトを追加する方法を参照してください。

手順

  1. Git エンドポイントを定義します。
    1. [エンドポイント] > [新規エンドポイント] の順にクリックします。
    2. プロジェクトを選択し、エンドポイント タイプとして [Git] を選択します。次に、名前と説明を入力します。
    3. このエンドポイントがインフラストラクチャのビジネス クリティカルなコンポーネントである場合は、[制限付きとしてマーク] を有効にします。
    4. このエンドポイントがオンプレミスにある場合は、このエンドポイントを Code Stream に接続するクラウド プロキシを選択します。そうでない場合は、設定を [デフォルト] のままにします。
    5. サポートされている Git サーバ タイプの 1 つを選択します。
    6. パスに含まれるサーバへの API ゲートウェイを持つリポジトリの URL を入力します。たとえば、https://api.github.com/vmware-example/repo-example と入力します。
    7. エンドポイントが配置されるリポジトリ内のブランチを入力します。
    8. 認証タイプを選択し、GitHub、GitLab、または BitBucket のユーザー名を入力します。次に、そのユーザー名とペアになっているパスワード、プライベート トークン、またはプライベート キーを入力します。
      • パスワードの場合:パスワードは、リポジトリへの完全なアクセスを提供します。また、パスワードの変数を作成することもできます。

        機密性のある情報を非表示および暗号化するには、シークレット変数を使用します。非表示にして暗号化するだけでなく、実行時に使用を制限する文字列、パスワード、URL については、制限付き変数を使用します。たとえば、パスワードや URL にシークレット変数を使用します。シークレット変数も制限付き変数も、パイプライン内の任意のタイプのタスクで使用できます。

      • プライベート トークンの場合:このトークンは Git 固有であり、特定のアクションへのアクセスを提供します。https://docs.gitlab.com/ee/user/profile/personal_access_tokens.htmlを参照してください。また、プライベート トークンの変数を作成することもできます。
      • プライベート キーの場合:この SSH キーは、特定のリポジトリへのアクセスを提供するプライベート キーです。Git イベントが発生すると、 Code Stream がこのキーを使用してリポジトリをクローン作成します。https://help.github.com/articles/reviewing-your-ssh-keys/を参照してください。
  2. [検証] をクリックし、エンドポイントが Code Stream.に接続することを確認します。
    接続しない場合は、エラーを修正してから [作成] をクリックします。
    Git エンドポイントを使用したコードのビルドとテスト

次のタスク

詳細については、他のセクションを参照してください。Code Streamで Git トリガを使用してパイプラインを実行する方法を参照してください。