デプロイメントガイド

手順

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. ワークステーションでターミナルを開き、コマンドラインインターフェイスを使用して 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-aws.yaml

   Copy to Clipboard Toggle word wrap

4. RHTPA 値ファイルテンプレート をコピーして、新しい value-rhtpa-aws.yaml ファイルに貼り付けます。

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

   1. REGIONAL_ENDPOINT は、Amazon S3 ストレージおよび Amazon SQS エンドポイント URL に置き換えます。
   2. COGNITO_DOMAIN_URL は Amazon Cognito URL に置き換えます。この情報は、AWS Cognito Console の App Integration タブにあります。
   3. REGION、USER_POOL_ID、および FRONTEND_CLIENT_ID および WALKER_CLIENT_ID は、関連する Amazon Cognito 情報に置き換えます。この情報は、AWS Cognito Console、User pool overview セクション、および App Integration タブの App clients and analytics セクションで確認できます。
   4. UNIQUE_ID は、bombastic-、vexination-、v11y- の一意のバケット名に置き換えます。
   5. ファイルを保存して、エディターを終了します。

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. AWS 認証情報を使用して、SQS イベントバスシークレットリソースを作成します。

   構文

   apiVersion: v1
   kind: Secret
   metadata:
     name: event-bus-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: event-bus-credentials
     namespace: trusted-profile-analyzer
   type: Opaque
   data:
     aws_access_key_id: RHTPAEVENTBS1EXAMPLE
     aws_secret_access_key: mBaliKUtnFEMI/K6RDENG/aPxRfzCYEXAMPLEKEY
   EOF

   Copy to Clipboard Toggle word wrap

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

   構文

   apiVersion: v1
   kind: Secret
   metadata:
     name: oidc-walker
     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-walker
     namespace: trusted-profile-analyzer
   type: Opaque
   data:
     client-secret: 5460cc91-4e20-4edd-881c-b15b169f8a79
   EOF

   Copy to Clipboard Toggle word wrap

9. 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 を設定します。

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

    構文

    export NAMESPACE=PROJECT_NAME
    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

    例

    $ 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 install redhat-trusted-profile-analyzer openshift-helm-charts/redhat-trusted-profile-analyzer -n $NAMESPACE --values PATH_TO_VALUES_FILE --set-string appDomain=$APP_DOMAIN_URL

    Copy to Clipboard Toggle word wrap

    例

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

    Copy to Clipboard Toggle word wrap

    注記

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

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

    例

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

    Copy to Clipboard Toggle word wrap

15. スケジュールされた Cron ジョブが毎日実行され、RHTPA の最新の Common Vulnerabilities and Exposures (CVE) データを収集します。スケジュールされたジョブが実行されるまで待つのではなく、以下のコマンドを実行してこの Cron ジョブを手動で開始できます。

    例

    $ oc -n $NAMESPACE create job --from=cronjob/v11y-walker v11y-walker-now

    Copy to Clipboard Toggle word wrap

    Cron ジョブが完了したら、この Cron ジョブを削除します。

    例

    $ oc -n $NAMESPACE delete job v11y-walker-now

    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. AMQ_ENDPOINT_URL、および USER_NAME は、関連する AMQ Streams 情報に置き換えます。
   3. OIDC_ISSUER_URL、FRONTEND_CLIENT_ID、および WALKER_CLIENT_ID は、関連する OIDC 情報に置き換えます。
   4. ファイルを保存して、エディターを終了します。

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

   構文

   apiVersion: v1
   kind: Secret
   metadata:
     name: s3-credentials
     namespace: PROJECT_NAME
   type: Opaque
   data:
     user: USER_NAME
     password: PASSWORD

   Copy to Clipboard Toggle word wrap

   例

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

   Copy to Clipboard Toggle word wrap

7. 認証情報を使用して、AMQ Streams シークレットリソースを作成します。

   構文

   apiVersion: v1
   kind: Secret
   metadata:
     name: kafka-credentials
     namespace: PROJECT_NAME
   type: Opaque
   data:
     client_password: PASSWORD

   Copy to Clipboard Toggle word wrap

   例

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

   Copy to Clipboard Toggle word wrap

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

   構文

   apiVersion: v1
   kind: Secret
   metadata:
     name: oidc-walker
     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-walker
     namespace: trusted-profile-analyzer
   type: Opaque
   data:
     client-secret: 5460cc91-4e20-4edd-881c-b15b169f8a79
   EOF

   Copy to Clipboard Toggle word wrap

9. データベース認証情報を使用して、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

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

    構文

    export NAMESPACE=PROJECT_NAME
    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

    例

    $ 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 install redhat-trusted-profile-analyzer openshift-helm-charts/redhat-trusted-profile-analyzer -n $NAMESPACE --values PATH_TO_VALUES_FILE --set-string appDomain=$APP_DOMAIN_URL

    Copy to Clipboard Toggle word wrap

    例

    $ helm install redhat-trusted-profile-analyzer openshift-helm-charts/redhat-trusted-profile-analyzer -n $NAMESPACE --values values-rhtpa.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=spog-ui -o jsonpath='https://{.items[0].status.ingress[0].host}{"\n"}'

    Copy to Clipboard Toggle word wrap

15. スケジュールされた Cron ジョブが毎日実行され、RHTPA の最新の Common Vulnerabilities and Exposures (CVE) データを収集します。スケジュールされたジョブが実行されるまで待つのではなく、以下のコマンドを実行してこの Cron ジョブを手動で開始できます。

    例

    $ oc -n $NAMESPACE create job --from=cronjob/v11y-walker v11y-walker-now

    Copy to Clipboard Toggle word wrap

    Cron ジョブが完了したら、この Cron ジョブを削除します。

    例

    $ oc -n $NAMESPACE delete job v11y-walker-now

    Copy to Clipboard Toggle word wrap