第1章 インストールプラットフォームの選択

手順

1. cluster-admin ロールを持つユーザーで OpenShift Web コンソールにログインします。
2. Administrator パースペクティブで、Operators ナビゲーションメニューを展開し、OperatorHub をクリックします。
3. 検索フィールドに trusted と入力し、Red Hat Trusted Artifact Signer タイルをクリックします。
4. Install ボタンをクリックして、Operator の詳細を表示します。

5. デフォルト値を受け入れ、Install Operator ページで Install をクリックし、インストールが完了するまで待ちます。

   重要

   インストールが完了すると、新しいプロジェクトが自動的に作成されます。新しいプロジェクト名は trusted-artifact-signer です。

   注記

   Trusted Artifact Signer Operator は openshift-operators namespace にインストールされ、すべての依存関係が自動的にインストールされます。

6. オプション: デフォルトのデータベースの代わりに、Trusted Artifact Signer サービスに別のデータベースプロバイダーを使用できます。Amazon の Relational Database Service (RDS)、または OpenShift 上のデータベース (セルフマネージド) を使用する場合は、まずそちらの手順のいずれかを実行してから、このインストールを続行してください。他のデータベースプロバイダーのいずれかの設定が完了したら、この手順の次の手順に進むことができます。

7. Trusted Artifact Signer サービスをデプロイします。

   1. ナビゲーションメニューから Operator を展開し、Installed Operators をクリックします。
   2. プロジェクトのドロップダウンボックスから、trusted-artifact-signer を選択します。
   3. Red Hat Trusted Artifact Signer をクリックします。
   4. Securesign タブをクリックし、Create Securesign ボタンをクリックします。
   5. Create Securesign ページで、YAML view を選択します。

   6. このデプロイメント中に、Google OAuth、Amazon STS、Red Hat’s SSO、または GitHub OAuth を初期 OIDC プロバイダーとして設定できます。spec.fulcio.config.OIDCIssuers セクションで、OIDC プロバイダー URL を含む次の 3 行を編集し、ClientID を適切に設定します。

      例

      ...
      OIDCIssuers:
        - Issuer: 'OIDC_ISSUER_URL':
          ClientID: CLIENT_ID
          IssuerURL: 'OIDC_ISSUER_URL'
          Type: email
      ...

      重要

      同じ設定で複数の異なる OIDC プロバイダーを定義できます。

      注記

      Red Hat の SSO がすでに OIDC プロバイダーとして実装されている場合は、次のコマンドを実行して発行者の URL を見つけます。

      $ echo https://$(oc get route keycloak -n keycloak-system | tail -n 1 | awk '{print $2}')/auth/realms/trusted-artifact-signer

      ClientID を trusted-artifact-signer に設定します。

   7. オプション: デフォルト以外のデータベースを使用する場合は、spec.trillian セクションで create を false に設定し、データベースシークレットオブジェクトの名前を付けます。

      例

      ...
      trillian:
        database:
          create: false
          databaseSecretRef:
            name: trillian-mysql
      ...

   8. Create ボタンをクリックします。

8. All instances タブをクリックして、CTlog、Fulcio、Rekor、Trillian、および TUF インスタンスの準備ができるまでデプロイメントステータスを監視します。

   注記

   Securesign インスタンスからは、ステータスはわかりません。

9. OpenShift コンソールで Prometheus を使用すると、新しい Trusted Artifact Signer サービスの健全性を確認できます。ナビゲーションメニューから Observe を展開し、Dashboards をクリックします。
10. コンテナーイメージ または Git コミット に署名して、インストールを検証します。