IBM App Connect の使い方 GitHub
GitHub は、ソフトウェア開発とバージョン管理のためのインターネット Git リポジトリホスティングサービスです。 分散型リビジョン管理とソースコード管理（SCM）機能を提供し、 Git、アクセス制御、バグ追跡、ソフトウェア機能要求、タスク管理、継続的インテグレーション、Wikiをすべてのプロジェクトに提供する。
- App Connect コネクタ
コンテナ内のローカルコネクタ（継続的デリバリー版）12.0.7.0-r1 以降
コンテナ内のローカルコネクタ（ Cycle-2 の長期サポート版）
接続先 GitHub
「 App Connect Designer」 の ] ページ（旧 [Catalog ] ページ） またはフローエディタに表示される接続フィールドに入力してください。 必要に応じて GitHub 管理者と協力してこれらの値を取得してください。
- GitHub Enterprise サーバー
- GitHub クラウド
| アプリケーション・タイプ | 認証タイプ App Connect in containers ) | 認証タイプ App Connect ) | 接続フィールド |
|---|---|---|---|
| GitHub クラウド | App Connect が使用する認証情報を提供する（BASIC） | App Connect が使用する認証情報を提供する（BASIC） | パーソナル・アクセス・トークン |
| GitHub クラウド | App Connect が使用する認証情報を提供する（BASIC OAUTH） | App Connect が使用する認証情報を提供する（BASIC OAUTH） | アクセス・トークン |
| GitHub クラウド | アプリケーションのウェブサイトを使ってサインインする（OAUTH 2.0 AUTH CODE） | ||
| GitHub Enterprise サーバー | App Connect が使用する認証情報を提供する（BASIC） | App Connect が使用する認証情報を提供する（BASIC） | エンドポイント URL およびパーソナル・アクセストークン |
| GitHub Enterprise サーバー | App Connect が使用する認証情報を提供する（BASIC OAUTH） | App Connect が使用する認証情報を提供する（BASIC OAUTH） | エンドポイント URL とアクセストークン |
| 接続フィールド | 説明 |
|---|---|
| エンドポイントURL | インスタンスの URL GitHub インスタンスを https:// <ホスト名> の形式で指定する。 |
| パーソナル・アクセス・トークン | APIにアクセスするための個人アクセストークン。 GitHub APIにアクセスするための個人アクセストークン。 個人アクセストークンを GitHub アカウント設定ページから |
| アクセス・トークン | アプリケーションのクライアントID、テナントID、クライアントシークレット、スコープ、グラントタイプ、ユーザー名、パスワードから生成されるアクセストークン。 |
GitHub の接続値を取得するには、 GitHub の接続値の取得」を参照してください。
エンドポイントに接続するには GitHubApp Connect Designer の [Applications and APIs ] ページからエンドポイントに初めて接続するには、 を展開し GitHub を展開し、[ Connect] をクリックします。 詳細については、 アカウントの管理を参照してください。
で作成したアカウントをフローで使用する前に App Connect で作成されたアカウントをフローで使用する前に、そのアカウントを識別できるような意味のある名前に変更してください。 アプリケーションとAPI] ページでアカウント名を変更するには、アカウントを選択し、オプションメニュー(Ȯ)を開き、[ アカウント名の変更 ]をクリックします。
一般的な考慮事項
で App Connect Designer を使用する前に、以下の点に注意してください。 GitHub を使用する前に、以下の点に注意してください：
- コネクタへの接続には、
repoやdelete_repoなどのスコープが必要です。 GitHub のようなスコープが必要です。 これらのスコープに関する詳細については、 GitHub のドキュメントページにある 「 OAuth アプリのスコープ」 をご覧ください。 - 組織オブジェクトを除き、何らかの操作を行うには、ドロップダウンリストから組織を選択する必要があります。Issues オブジェクトから issueの作成アクションを使用する以下の例では、リストの最初のオプションが認証済みユーザのログインIDに対応し、残りのリストがユーザの所属する組織IDに対応しています：
ここで、リストからログインIDを選択すると、個人リポジトリを選択して、作成、取得、更新、削除操作やカスタムイベント操作を実行することができます。
- 一部のオブジェクト （レビュー、 コミットコメント、 レビューコメント、 コメント ）については、単一のオブジェクトを取得するためにIDフィルタを使用すると、選択されている必須のドロップダウンリストの値は無視されます。以下の例では、 レビューID フィルターに値を入力した場合、ドロップダウンリストで選択した Pullリクエスト値は無視されます。
また、この例では、 レビューID 以外のフィルタ値を選択した場合、またはフィルタを適用しなかった場合、選択した Pullリクエスト値のすべてのレビューが表示されます。
- (一般的な考察) App Connect Designerの Applications and APIs ページで利用可能なトリガーイベントとアクションのリストを見ることができます。
アプリケーションによっては、イベントとアクションは環境と、コネクタが設定可能なイベントとアクションの動的検出をサポートしているかどうかに依存する。 アプリケーションが設定可能なイベントをサポートしている場合、イベント・リストの下に Show more configurable events リンクが表示されます。 アプリケーションがアクションのダイナミックディスカバリーをサポートしている場合、アクションリストの下に Show more リンクが表示されます。
- (一般的な考慮事項）アプリケーションに複数のアカウントを使用している場合、そのアプリケーションのアクションを選択したときに表示されるフィールドのセットは、アカウントによって異なる可能性があります。 フローエディターでは、アプリケーションによっては、常にアクションのための静的フィールドのキュレーションセットを提供します。 他のアプリケーションは、接続先のインスタンスで設定されているフィールドのセットを取得するために、ダイナミック・ディスカバリーを使用します。 例えば、あるアプリケーションの2つのインスタンスに2つのアカウントがある場合、最初のアカウントはすぐに使える設定を使うかもしれません。 しかし、2つ目のアカウントには余分なカスタムフィールドが設定されている可能性があります。
出来事と行動
GitHub イベント
これらのイベントは、フロー内のアクションを完了するためにフローを開始するトリガーとなる、このアプリケーションの変更に対するものである。
より多くの設定可能なイベントを表示します：デフォルトで表示されるイベントは、最適化された接続を使用して事前に設定されています。 新しいオブジェクトや更新されたオブジェクトについてこのアプリケーションをポーリングしてフローをトリガーできるイベントを設定すると、さらに多くの項目が利用できるようになります。
GitHub 行動
あなたのフローは、このアプリケーション上でこれらのアクションを完了します。
| オブジェクト | アクション | 説明 |
|---|---|---|
| ブランチ | マージブランチ | ブランチをマージする |
| 枝の検索 | 枝の検索 | |
| 問題 | 割り当て対象者の追加 | issueにアサイニーを追加 |
| 問題の作成 | issueの作成 | |
| 譲受人の削除 | issueからassigneeを削除します | |
| 問題の検索 | 課題の検索 | |
| 問題の更新 | 問題の更新 | |
| 組織 | 組織の検索 | 組織を検索する |
| 組織の更新 | 組織を更新する | |
| プル要求 | プルリクエストの作成 | プルリクエストを作成する |
| プルリクエストをマージする | プルリクエストをマージする | |
| プルリクエストの取得 | プルリクエストを取得する | |
| プルリクエストの更新 | プルリクエストを更新する | |
| リポジトリー | リポジトリーの作成 | リポジトリを作成する |
| リポジトリーの削除 | リポジトリを削除する | |
| リポジトリの取得 | リポジトリを取得する | |
| リポジトリの更新 | リポジトリの更新 |
App Connect に接続すると、より多くのアイテムが利用可能になります。 GitHub.
例
テンプレートを使って、以下のフローを素早く作成する。 GitHub
テンプレートを使って App Connect テンプレートを使って GitHub. 例えば、 Discoverを開き、 GitHub を検索する。
使用方法 App Connect と統合するフローを構築する。 GitHub.
Jira で新しい問題が作成されたときに GitHub でリポジトリーまたは問題を作成する方法については、 IBM® コミュニティーのブログをお読みください。 ブログを読む 」をクリックするとブログにジャンプします。