デプロイメントガイド

手順

1. Red Hat 認証情報を使用して Red Hat Hybrid Cloud コンソール にログインします。
2. ホームページから、Services ドロップダウンメニューをクリックし、Red Hat Ansible Automation Platform をクリックします。
3. ナビゲーションメニューから Automation Hub を展開し、Collections をクリックします。
4. 検索フィールドに rhtpa と入力し、Enter キーを押します。
5. Red Hat Trusted Profile Analyzer タイルの trusted_profile_analyzer リンクをクリックします。

6. Documentation タブをクリックし、そこに記載されている手順に従って、Red Hat Enterprise Linux への RHTPA のインストールを完了します。

   注記

   すべての設定パラメーターの詳細な概要は、Roles セクションの tpa_single_node リンクをクリックしてください。

手順

1. cluster-admin ロールを持つユーザーで OpenShift Web コンソールにログインします。
2. Administrator パースペクティブで、Operators ナビゲーションメニューを展開し、OperatorHub をクリックします。
3. 検索フィールドに trusted と入力し、Red Hat Trusted Profile Analyzer タイルをクリックします。
4. Install ボタンをクリックして、Operator の詳細を表示します。
5. Install Operator ページで、ドロップダウンメニューからインストール名前空間を選択するか、新しいプロジェクト名前空間を作成します。残りのデフォルト値を受け入れて、Install ボタンをクリックします。インストールが完了するまで待ちます。
6. RHTPA Operator のインストールが完了したら、View Operator ボタンをクリックします。

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

   1. Red Hat Trusted Profile Analyzer Operator ページの Details タブで、TrustedProfileAnalyzer タイルの Create instance リンクをクリックします。
   2. Create TrustedProfileAnalyzer ページで、YAML view を選択します。
   3. AWS サービス または Red Hat サービス の Helm チャートから OIDC プロバイダー、ストレージ、およびインポーターのセクションをコピーし、仕様 セクションの下に貼り付けます。
   4. 環境に合わせて OIDC プロバイダー、ストレージ、およびインポーターの値を更新します。
   5. Create ボタンをクリックします。
8. Pod が稼働していることを確認して、新しい Trusted Profile Analyzer サービスの健全性を確認できます。アクセスルート URL が公開されていること、Trusted Profile Analyzer サービスにアクセスできることも検証できます。

手順

1. ワークステーションでターミナルを開き、コマンドラインインターフェイスを使用して OpenShift にログインします。

   oc login --token=TOKEN --server=SERVER_URL_AND_PORT

   Copy to Clipboard Toggle word wrap

   $ oc login --token=sha256~ZvFDBvoIYAbVECixS4-WmkN4RfnNd8Neh3y1WuiFPXC --server=https://example.com:6443

   Copy to Clipboard Toggle word wrap
   注記

   OpenShift Web コンソールからコマンドラインで使用するログイントークンと URL を確認できます。OpenShift Web コンソールにログインします。ユーザー名をクリックし、Copy login command をクリックします。ユーザー名とパスワードをもう一度入力し、Display Token をクリックしてコマンドを表示します。

2. RHTPA デプロイメントの新規プロジェクトを作成します。

   oc new-project PROJECT_NAME

   Copy to Clipboard Toggle word wrap

   $ oc new-project trusted-profile-analyzer

   Copy to Clipboard Toggle word wrap

3. 新規ファイルを開いて編集します。

   $ vi values-rhtpa.yaml

   Copy to Clipboard Toggle word wrap
4. RHTPA 値ファイルテンプレート をコピーして、新しい values-rhtpa.yaml ファイルに貼り付けます。

5. 関連する AWS 情報を使用して values-rhtpa.yaml ファイルを更新します。

   1. REGION、USER_POOL_ID、および FRONTEND_CLIENT_ID および CLI_CLIENT_ID は、関連する Amazon Cognito 情報に置き換えます。この情報は、AWS Cognito Console の User pool overview セクションで確認できます。
   2. UNIQUE_ID を、trustify -S3 バケットの一意のバケット名に置き換えます。
   3. ファイルを保存して、エディターを終了します。

6. AWS 認証情報を使用して、S3 ストレージシークレットリソースを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: storage-credentials
     namespace: PROJECT_NAME
   type: Opaque
   data:
     aws_access_key_id: AWS_ACCESS_KEY
     aws_secret_access_key: AWS_SECRET_KEY

   Copy to Clipboard Toggle word wrap

   $ cat <<EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: storage-credentials
     namespace: trusted-profile-analyzer
   type: Opaque
   data:
     aws_access_key_id: RHTPASTORAGE1EXAMPLE
     aws_secret_access_key: xBalrKUtnFEMI/K7RDENG/aPxRfzCYEXAMPLEKEY
   EOF

   Copy to Clipboard Toggle word wrap

7. OpenID Connect (OIDC) クライアントシークレットリソースを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: oidc-cli
     namespace: PROJECT_NAME
   type: Opaque
   data:
     client-secret: SECRET

   Copy to Clipboard Toggle word wrap

   $ cat <<EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: oidc-cli
     namespace: trusted-profile-analyzer
   type: Opaque
   data:
     client-secret: 5460cc91-4e20-4edd-881c-b15b169f8a79
   EOF

   Copy to Clipboard Toggle word wrap

8. Amazon RDS 認証情報を使用して、2 つの PostgreSQL データベースシークレットリソースを作成します。

   1. PostgreSQL 標準ユーザーシークレットリソース:

      apiVersion: v1
      kind: Secret
      metadata:
        name: postgresql-credentials
        namespace: PROJECT_NAME
      type: Opaque
      data:
        db.host: DB_HOST
        db.name: DB_NAME
        db.user: USERNAME
        db.password: PASSWORD
        db.port: PORT

      Copy to Clipboard Toggle word wrap

      $ cat <<EOF | oc apply -f -
      apiVersion: v1
      kind: Secret
      metadata:
        name: postgresql-credentials
        namespace: trusted-profile-analyzer
      type: Opaque
      data:
        data:
        db.host: rds.us-east-1.amazonaws.com
        db.name: rhtpadb
        db.user: jdoe
        db.password: example1234
        db.port: 5432
      EOF

      Copy to Clipboard Toggle word wrap

   2. PostgreSQL 管理者シークレットリソース:

      apiVersion: v1
      kind: Secret
      metadata:
        name: postgresql-admin-credentials
        namespace: PROJECT_NAME
      type: Opaque
      data:
        db.host: DB_HOST
        db.name: DB_NAME
        db.user: USERNAME
        db.password: PASSWORD
        db.port: PORT

      Copy to Clipboard Toggle word wrap

      $ cat <<EOF | oc apply -f -
      apiVersion: v1
      kind: Secret
      metadata:
        name: postgresql-admin-credentials
        namespace: trusted-profile-analyzer
      type: Opaque
      data:
        data:
        db.host: rds.us-east-1.amazonaws.com
        db.name: rhtpadb
        db.user: admin
        db.password: example1234
        db.port: 5432
      EOF

      Copy to Clipboard Toggle word wrap
   3. AWS マネジメントコンソールから、ポート 5432 を許可するように Amazon Virtual Private Cloud (VPC) security group を設定します。

9. 新規ファイルを開いて編集します。

   $ vi values-importers.yaml

   Copy to Clipboard Toggle word wrap
   1. RHTPA インポーター値ファイルテンプレート をコピーして、新しい values-importers.yaml ファイルに貼り付けます。
   2. ファイルを保存して、エディターを終了します。

10. シェル環境を設定します。

    $ export NAMESPACE=trusted-profile-analyzer
    $ export APP_DOMAIN_URL=-$NAMESPACE.$(oc -n openshift-ingress-operator get ingresscontrollers.operator.openshift.io default -o jsonpath='{.status.domain}')

    Copy to Clipboard Toggle word wrap

11. OpenShift Helm チャートリポジトリーを追加します。

    $ helm repo add openshift-helm-charts https://charts.openshift.io/

    Copy to Clipboard Toggle word wrap

12. Helm チャートリポジトリーから最新のチャート情報を取得します。

    $ helm repo update

    Copy to Clipboard Toggle word wrap

13. Helm チャートを実行します。

    helm upgrade --install redhat-trusted-profile-analyzer openshift-helm-charts/redhat-trusted-profile-analyzer -n $NAMESPACE --values PATH_TO_VALUES_FILE --values PATH_TO_IMPORTER_VALUES_FILE --set-string appDomain=$APP_DOMAIN_URL

    Copy to Clipboard Toggle word wrap

    $ helm upgrade --install redhat-trusted-profile-analyzer openshift-helm-charts/redhat-trusted-profile-analyzer -n $NAMESPACE --values values-rhtpa.yaml --values values-importers.yaml --set-string appDomain=$APP_DOMAIN_URL

    Copy to Clipboard Toggle word wrap
    注記

    この Helm チャートを何度も実行して、値ファイルから現在設定されている状態を適用できます。

14. インストールが完了したら、OIDC プロバイダーからのユーザー認証情報を使用して RHTPA コンソールにログインできます。次のコマンドを実行すると、RHTPA コンソール URL を見つけることができます。

    $ oc -n $NAMESPACE get route --selector app.kubernetes.io/name=server -o jsonpath='https://{.items[0].status.ingress[0].host}{"\n"}'

    Copy to Clipboard Toggle word wrap

手順

1. ワークステーションでターミナルを開き、コマンドラインインターフェイスを使用して OpenShift にログインします。

   oc login --token=TOKEN --server=SERVER_URL_AND_PORT

   Copy to Clipboard Toggle word wrap

   $ oc login --token=sha256~ZvFDBvoIYAbVECixS4-WmkN4RfnNd8Neh3y1WuiFPXC --server=https://example.com:6443

   Copy to Clipboard Toggle word wrap
   注記

   OpenShift Web コンソールからコマンドラインで使用するログイントークンと URL を確認できます。OpenShift Web コンソールにログインします。ユーザー名をクリックし、Copy login command をクリックします。ユーザー名とパスワードをもう一度入力し、Display Token をクリックしてコマンドを表示します。

2. RHTPA デプロイメントの新規プロジェクトを作成します。

   oc new-project PROJECT_NAME

   Copy to Clipboard Toggle word wrap

   $ oc new-project trusted-profile-analyzer

   Copy to Clipboard Toggle word wrap

3. 新規ファイルを開いて編集します。

   $ vi values-rhtpa.yaml

   Copy to Clipboard Toggle word wrap
4. RHTPA 値ファイルテンプレート をコピーして、新しい values-rhtpa.yaml ファイルに貼り付けます。

5. 使用予定の情報で values-rhtpa.yaml ファイルを更新します。

   1. S3_ENDPOINT_URL は、関連する S3 ストレージ情報に置き換えます。
   2. OIDC_ISSUER_URL、FRONTEND_CLIENT_ID、および CLI_CLIENT_ID を関連する OIDC 情報に置き換えます。
   3. ファイルを保存して、エディターを終了します。

6. 認証情報を使用して S3 ストレージシークレットリソースを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: storage-credentials
     namespace: PROJECT_NAME
   type: Opaque
   data:
     user: ACCESS_KEY
     password: SECRET_KEY

   Copy to Clipboard Toggle word wrap

   $ cat <<EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: storage-credentials
     namespace: trusted-profile-analyzer
   type: Opaque
   data:
     user: root
     password: example123
   EOF

   Copy to Clipboard Toggle word wrap

7. OIDC クライアントシークレットリソースを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: oidc-cli
     namespace: PROJECT_NAME
   type: Opaque
   data:
     client-secret: SECRET

   Copy to Clipboard Toggle word wrap

   $ cat <<EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: oidc-cli
     namespace: trusted-profile-analyzer
   type: Opaque
   data:
     client-secret: 5460cc91-4e20-4edd-881c-b15b169f8a79
   EOF

   Copy to Clipboard Toggle word wrap

8. データベース認証情報を使用して、2 つの PostgreSQL データベースシークレットリソースを作成します。

   1. PostgreSQL 標準ユーザーシークレットリソース:

      apiVersion: v1
      kind: Secret
      metadata:
        name: postgresql-credentials
        namespace: PROJECT_NAME
      type: Opaque
      data:
        db.host: DB_HOST
        db.name: DB_NAME
        db.user: USERNAME
        db.password: PASSWORD
        db.port: PORT

      Copy to Clipboard Toggle word wrap

      $ cat <<EOF | oc apply -f -
      apiVersion: v1
      kind: Secret
      metadata:
        name: postgresql-credentials
        namespace: trusted-profile-analyzer
      type: Opaque
      data:
        data:
        db.host: postgresql.example.com
        db.name: rhtpadb
        db.user: jdoe
        db.password: example1234
        db.port: 5432
      EOF

      Copy to Clipboard Toggle word wrap

   2. PostgreSQL 管理者シークレットリソース:

      apiVersion: v1
      kind: Secret
      metadata:
        name: postgresql-admin-credentials
        namespace: PROJECT_NAME
      type: Opaque
      data:
        db.host: DB_HOST
        db.name: DB_NAME
        db.user: USERNAME
        db.password: PASSWORD
        db.port: PORT

      Copy to Clipboard Toggle word wrap

      $ cat <<EOF | oc apply -f -
      apiVersion: v1
      kind: Secret
      metadata:
        name: postgresql-admin-credentials
        namespace: trusted-profile-analyzer
      type: Opaque
      data:
        data:
        db.host: postgresql.example.com
        db.name: rhtpadb
        db.user: admin
        db.password: example1234
        db.port: 5432
      EOF

      Copy to Clipboard Toggle word wrap

9. 新規ファイルを開いて編集します。

   $ vi values-importers.yaml

   Copy to Clipboard Toggle word wrap
   1. RHTPA インポーター値ファイルテンプレート をコピーして、新しい values-importers.yaml ファイルに貼り付けます。
   2. ファイルを保存して、エディターを終了します。

10. シェル環境を設定します。

    $ export NAMESPACE=trusted-profile-analyzer
    $ export APP_DOMAIN_URL=-$NAMESPACE.$(oc -n openshift-ingress-operator get ingresscontrollers.operator.openshift.io default -o jsonpath='{.status.domain}')

    Copy to Clipboard Toggle word wrap

11. OpenShift Helm チャートリポジトリーを追加します。

    $ helm repo add openshift-helm-charts https://charts.openshift.io/

    Copy to Clipboard Toggle word wrap

12. Helm チャートリポジトリーから最新のチャート情報を取得します。

    $ helm repo update

    Copy to Clipboard Toggle word wrap

13. Helm チャートを実行します。

    helm upgrade --install redhat-trusted-profile-analyzer openshift-helm-charts/redhat-trusted-profile-analyzer -n $NAMESPACE --values PATH_TO_VALUES_FILE --values PATH_TO_IMPORTER_VALUES_FILE --set-string appDomain=$APP_DOMAIN_URL

    Copy to Clipboard Toggle word wrap

    $ helm upgrade --install redhat-trusted-profile-analyzer openshift-helm-charts/redhat-trusted-profile-analyzer -n $NAMESPACE --values values-rhtpa.yaml --values values-importers.yaml --set-string appDomain=$APP_DOMAIN_URL

    Copy to Clipboard Toggle word wrap
    注記

    この Helm チャートを何度も実行して、値ファイルから現在設定されている状態を適用できます。

14. インストールが完了したら、OIDC プロバイダーからのユーザー認証情報を使用して RHTPA コンソールにログインできます。次のコマンドを実行すると、RHTPA コンソール URL を見つけることができます。

    $ oc -n $NAMESPACE get route --selector app.kubernetes.io/name=server -o jsonpath='https://{.items[0].status.ingress[0].host}{"\n"}'

    Copy to Clipboard Toggle word wrap