第1章 RHTAP 用の GitHub アプリケーションの作成

手順

1. GitHub にログインし、組織 (Settings > Organizations) に移動します。
2. お客様が所有し、RHTAP のこのインスタンスに使用する組織をクリックします。または、New organization を選択して新しい組織を作成することもできます。
3. 組織のコンテキストで、GitHub Apps ページ (Settings > Developer settings > GitHub Apps) に移動します。
4. ページの右側、上部のバナーの近くにある New GitHub App を選択します。
5. プロンプトが表示されたら、必要に応じて認証します。
6. GitHub App name フィールドに一意の名前を入力します。
7. Homepage URL フィールドにプレースホルダー値 (例: https://www.placeholder.com) を入力します。
8. Callback URL フィールドにプレースホルダー値を入力します。同じプレースホルダー値 (例: https://www.placeholder.com) を使用できます。
9. Webhook URL フィールドにプレースホルダー値を入力します。同じプレースホルダー値 (例: https://www.placeholder.com) を使用できます。また、Active チェックボックスがオンになっていることを確認します (GitHub ではデフォルトでオンになっているはずです)。

10. ローカルシステムに新しいファイルを作成します。このファイルには、インストールプロセスの後の手順で必要になるいくつかの値を保存します。このファイルに値を入力するときは、後で各値が何であるかを思い出せるように必ずラベルを付けてください。

    $ touch ~/install_values.txt

11. CLI でシークレットを生成し、ラベルを付けて ~/install_values.txt に保存します。

    1. OpenSSL をお持ちでない場合は、ダウンロード手順 に従ってください。

       $ openssl rand -hex 20 >> ~/install_values.txt

       重要

       このコマンドの出力を必ず保存してください。

12. GitHub の Webhook secret フィールドに、先ほどのコマンドの出力を入力します。

13. Repository permissions で、次の権限を設定します。

    1. Administration: Read and write
    2. Checks: Read and write
    3. Contents: Read and write
    4. Issues: Read and write
    5. Metadata: Read-only (すでに正しく設定されているはずですが、値を確認してください)
    6. Pull requests: Read and write

14. Organization permissions で、次の権限を設定します。

    1. Members: Read-only
    2. Plan: Read-only

15. Subscribe to events で、次のサブスクリプションを選択します。

    1. Check run
    2. Check suite
    3. Commit comment
    4. Issue comment
    5. Pull request
    6. Push
16. Where can this GitHub App be installed? で Any account を選択します。
17. Create GitHub App をクリックします。すると、Developer Settings ページが表示されます。

18. Client ID と Application ID を取得します。ラベルを付けて ~install_values.txt に保存します。

    重要

    次の 2 つの手順では、クライアントシークレットと秘密鍵を収集する方法を説明します。RHTAP のインストールプロセスを完了するには、クライアントシークレットと秘密鍵を保存し、アクセス可能な状態にしておく必要があります。

19. 新しいアプリケーションのページで、Client secrets の横にある Generate a new client secret を選択します。クライアントシークレットにラベルを付けて、~/install_values.txt に保存します。
20. GitHub の同じページの Private keys で、Generate a private key ボタンを選択します。秘密鍵を含む private-key ファイルがダウンロードされます。秘密鍵ファイルの内容にラベルを付けて、~/install_values.txt に保存します。秘密鍵は -----BEGIN RSA PRIVATE KEY----- で始まり、-----END RSA PRIVATE KEY----- で終わるようにする必要があります。
21. 引き続き GitHub の同じページで、左側のタブから Install App を選択します。
22. 組織名の横にある緑色の Install ボタンを使用します。
23. プロンプトが表示されたら、All repositories を選択して、RHTAP が組織内に新しいリポジトリーを作成できるようにします。緑色の Install ボタンをクリックします。