事前準備

HULFT10 for Container Platformの導入にあたって、事前準備が必要です。

ここでは事前準備について、Red Hat OpenShiftおよびRed Hat OpenShift CLIが導入されていることを前提に説明します。db.authorizationSecretの定義

HULFT10 for Container Platformを導入するプロジェクトの作成

Red Hat OpenShiftに、HULFT10 for Container Platformを導入するプロジェクトを新規に作成します。

既存のプロジェクトにHULFT10 for Container Platformを導入する場合は、この手順は不要です。

 

Red Hat OpenShift CLIで、HULFT10 for Container Platformを導入する新規プロジェクトを作成するには以下のコマンドを実行します。

oc new-project <HULFTを導入するプロジェクトの名前>

設定例

oc new-project hulft-project

データベースの導入

HULFT10 for Container Platformをご使用いただくには、HULFT10 for Container Platformで利用するデータ情報を格納するため、データベースが必要です。

既存のデータベースを使用することもできます。

データベースの作成

HULFTはデータベースにHULFT用のテーブルを作成して動作するため、事前にこのデータベースを作成しておく必要があります。

以下の手順は、MySQLのデータベースを作成する手順の一例です。

 

1. MySQLにログインして接続します。

   コマンド例

   mysql -u root -p

   このコマンドを入力した後、パスワードを入力します。

    

2. MySQLにデータベースを作成するには、以下のコマンドを実行します。

   CREATE DATABASE <HULFTのテーブルを作成するデータベースの名前>;

   設定例

   CREATE DATABASE hulft;

3. データベースが作成されたことを確認するには、以下のコマンドを実行します。

   SHOW DATABASES LIKE "<HULFTのテーブルを作成するデータベースの名前>";

   設定例

   SHOW DATABASES LIKE "hulft";

    

   データベースが作成されると、以下の内容が表示されます。

   +-----------------------------------------------+
   | Database (hulft)                              |
   +-----------------------------------------------+
   | <HULFTのテーブルを作成するデータベースの名前> |
   +-----------------------------------------------+
   1 row in set (0.0013 sec)
   

   実行例

   +-------------------------------------------+
   | Database (hulft)                          |
   +-------------------------------------------+
   | hulft　　　　　　　　　　　　　　　　　　 |
   +-------------------------------------------+
   1 row in set (0.0013 sec)
   

永続ボリュームの作成（任意）

Red Hat OpenShift上に転送コンテナ用のファイルの置き場所を作成する場合は、永続ボリュームが必要です。

以下に、永続ボリュームとしてのPersistentVolume（PV）およびPersistentVolumeClaim（PVC）を作成する例を説明します。

PVの作成

NFSをマウントするための以下のマニフェストファイルを、ローカルに作成します。

nfs-pv.yaml

apiVersion: v1
kind: PersistentVolume
metadata:
  name: <任意の永続ボリューム名>
  namespace: <HULFTを導入するプロジェクトの名前>
spec:
  capacity:
    storage: <任意のストレージサイズ>
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain
  nfs:
    server: <マウントするNFSのホスト名>
    path: <マウントするNFSのパス>
  storageClassName: <永続ボリュームのストレージクラス名>

設定例

apiVersion: v1
kind: PersistentVolume
metadata:
  name: nfs-volume-pv
  namespace: hulft-project
spec:
  capacity:
    storage: 2Gi
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain
  nfs:
    server: xxx.xxx.com
    path: /
  storageClassName: nfs-pv

 

永続ボリュームを適用するには、以下のコマンドを実行します。

oc apply -f nfs-pv.yaml

 

適用に成功すると以下が表示されます。

persistentvolume/nfs-volume-pv created

PVCの作成

NFSをマウントするための以下のマニフェストファイルを、ローカルに作成します。

nfs-pvc.yaml

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: <作成するPersistentVolumeClaimの名前>
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: <必要なストレージサイズ>
  storageClassName: <作成したPersistentVolumeと同じストレージクラス名>

設定例

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: nfs-volume-pvc
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 2Gi
  storageClassName: nfs-pv

 

永続ボリュームを適用するには、以下のコマンドを実行します。

oc apply -f nfs-pvc.yaml

 

適用に成功すると以下が表示されます。

persistentvolumeclaim/nfs-volume-pvc created

cert-managerの導入

TLS接続を行うための証明書を発行するcert-managerの導入手順を説明します。

シークレット情報の定義（必須）

HULFT10 for Container Platformを使用するために、必須のシークレット情報の定義について説明します。

 

シークレット情報を定義する前に、HULFT10 for Container Platformを導入するプロジェクトに移動してください。

Red Hat OpenShift CLIで、HULFT10 for Container Platformを導入するプロジェクトに移動するには以下のコマンドを実行します。

oc project <HULFTを導入するプロジェクトの名前>

設定例

oc project hulft-project

licenseSecretの定義

licenseSecretを定義する手順を以下に説明します。

1. ローカルに、以下のlicenseSecretを定義するマニフェストファイルを作成します。

   license_secret.yaml

   kind: Secret
   apiVersion: v1
   metadata:
     name: <作成するSecretリソースの名前>
     namespace: <HULFTを導入するプロジェクトの名前>
   stringData:
     productKey: <発行したプロダクトキー>
     serialNumber: <発行したシリアル番号>
     termLicenseKey: <発行した利用期間ライセンスキー> (*1)
   type: Opaque
   

   *1

   :

   評価版の場合、termLicenseKeyは発行されません。指定不要です。

   設定例

   kind: Secret
   apiVersion: v1
   metadata:
     name: hulft-license-secret
     namespace: hulft-project
   stringData:
     productKey: ABCDEFGHIJKLMNOPQRSTU
     serialNumber: "0123456789012"
     termLicenseKey: UTSRQPONMLKJIHGFEDCBA
   type: Opaque
   

    

   stringDataに誤った値を指定した場合、HULFTの導入後、管理コンテナに以下のメッセージが表示されます。

   The correct licence has not been specified.

   このメッセージが表示された場合は、マニフェストファイルに正しい値を指定しlicenseSecretを適用しなおしてください。

2. licenseSecretを適用するには、以下のコマンドを実行します。

   oc apply -f license_secret.yaml

    

   適用に成功すると以下が表示されます。

   secret / hulft-license-secret created

3. licesnseSecretのリソースが作成されたことを確認するには、以下のコマンドを実行します。

   oc get Secret <licenseSecretリソースの名前>

   設定例

   oc get Secret hulft-license-secret

    

   licenseSecretのリソースが作成されていると、以下が表示されます。

   NAME                    TYPE     DATA   AGE
   hulft-license-secret    Opaque   3      1d2h
   

db.authorizationSecretの定義

データベースにログインするユーザー名とパスワードをdb.authorizationSecretに定義する手順を以下に説明します。

 

ローカルに、以下のlicenseSecretを定義するマニフェストファイルを作成します。

db_authorization_secret.yaml

kind: Secret
apiVersion: v1
metadata:
  name: <作成するSecretリソースの名前>
  namespace: <HULFTを導入するプロジェクトの名前>
stringData:
  username: <データベースにログインするユーザー名>
  password: <データベースにログインするパスワード>
type: Opaque

設定例

kind: Secret
apiVersion: v1
metadata:
  name: hulft-db-authorization-secret
  namespace: hulft-project
stringData:
  username: uername
  password: password
type: Opaque

 

licenseSecretを適用するには、以下のコマンドを実行します。

oc apply -f db_authorization_secret.yaml

 

適用に成功すると以下が表示されます。

secret / hulft-db-authorization-secret created

 

db.authorizationSecretのリソースが作成されたことを確認するには、以下のコマンドを実行します。

oc get Secret <db.authorizationSecretリソースの名前>

設定例

oc get Secret hulft-db-authorization-secret

 

hulft-db-authorization-secretのリソースが作成されていると、以下が表示されます。

NAME                             TYPE     DATA   AGE
hulft-db-authorization-secret    Opaque   3      1d2h

シークレット情報の定義（任意）

HULFT10 for Container Platformを使用するために、任意のシークレット情報の定義について説明します。

 

シークレット情報を定義する前に、HULFT10 for Container Platformを導入するプロジェクトに移動してください。

Red Hat OpenShift CLIで、HULFT10 for Container Platformを導入するプロジェクトに移動するには以下のコマンドを実行します。

oc project <HULFTを導入するプロジェクトの名前>

設定例

oc project hulft-project

Amazon S3の認証情報の定義

ストレージとしてAmazon S3を使用するための設定手順を以下に説明します。

 

ローカルに以下のマニフェストファイルを作成します。

amazon_s3_authorization_secret.yaml

kind: Secret
apiVersion: v1
metadata:
  name: <Amazon S3認証情報のSecretリソースの名前>
  namespace: <HULFTを導入するプロジェクトの名前>
stringData:
  awsAccessKeyID: <AWSアクセスキー>
  awsSecretAccessKey: <AWSシークレットキー>
type: Opaque

 

マニフェストファイルを適用するには、以下のコマンドを実行します。

oc apply -f amazon_s3_authorization_secret.yaml

 

作成されたリソースを確認するには、以下のコマンドを実行します。

oc get Secret <Amazon S3認証情報のSecretリソースの名前>

 

リソースが作成されていたら、以下が表示されます。

NAME                                        TYPE     DATA   AGE
<Amazon S3認証情報のSecretリソースの名前>   Opaque   3      1d2h

TLSサーバー証明書の定義

ユーザーが発行したTLSサーバー証明書を使用するための設定手順を以下に説明します。

TLSサーバー証明書の発行は任意の方法で発行してください。 このとき発行するTLSサーバー証明書および秘密鍵はPEM形式としてください。

 

ローカルに以下のマニフェストファイルを作成します。

tls-server-certificate-secret.yaml

kind: Secret
apiVersion: v1
metadata:
  name: <TLSサーバー証明書のSecretリソースの名前>
  namespace: <HULFTを導入するプロジェクトの名前>
stringData:
  tls.key: <TLS秘密鍵>
  tls.crt: <TLS証明書>
type: Opaque

 

マニフェストファイルを適用するには、以下のコマンドを実行します。

oc apply -f tls-server-certificate-secret.yaml

 

作成されたリソースを確認するには、以下のコマンドを実行します。

oc get Secret <TLSサーバー証明書のSecretリソースの名前>

 

リソースが作成されていたら、以下が表示されます。

NAME                                      TYPE     DATA   AGE
<TLSサーバー証明書のSecretリソースの名前>   Opaque   3      1d2h

TLS CA証明書の定義

接続先にプライベート認証局で発行された証明書を使用している管理コンテナやHULFTがある場合に必要な設定手順を、以下に説明します。

接続先のHULFTや管理コンテナのTLS CA証明書を任意の方法で発行してください。 このとき使用するサーバー証明書および秘密鍵はPEM形式としてください。

 

ローカルに以下のマニフェストファイルを作成します。

tls-ca-certificate-secret.yaml

kind: Secret
apiVersion: v1
metadata:
  name: <TLS CA証明書のSecretリソースの名前>
  namespace: <HULFTを導入するプロジェクトの名前>
stringData:
  ca.crt: <TLS CA証明書>
type: Opaque

 

マニフェストファイルを適用するには、以下のコマンドを実行します。

oc apply -f tls-ca-certificate-secret.yaml

 

作成されたリソースを確認するには、以下のコマンドを実行します。

oc get Secret <TLS CA証明書のSecretリソースの名前>

 

リソースが作成されていたら、以下が表示されます。

NAME                                   TYPE     DATA   AGE
<TLS CA証明書のSecretリソースの名前>   Opaque   3      1d2h

SAML証明書の定義

SAML認証を行う場合に必要な設定手順を、以下に説明します。

SAML認証をする際に必要なSAML証明書やSAML秘密鍵を任意の方法で発行してください。 このとき用意するサーバー証明書および秘密鍵はPEM形式としてください。

 

ローカルに以下のマニフェストファイルを作成します。

saml-secret.yaml

kind: Secret
apiVersion: v1
metadata:
  name: <SAML証明書のSecretリソースの名前>
  namespace: <HULFTを導入するプロジェクトの名前>
stringData:
  key: <SAML秘密鍵>
  certificate: <SAML証明書>
type: Opaque

 

マニフェストファイルを適用するには、以下のコマンドを実行します。

oc apply -f saml-secret.yaml

 

作成されたリソースを確認するには、以下のコマンドを実行します。

oc get Secret <SAML証明書のSecretリソースの名前>

 

リソースが作成されていたら、以下が表示されます。

NAME                                 TYPE     DATA   AGE
<SAML証明書のSecretリソースの名前>   Opaque   3      1d2h

 

以上で、事前準備は完了です。