WAR アプリケーションアーカイブを取得したり、アプリケーションをローカルにビルドしたりします。

ローカルファイルシステムでディレクトリー構造を準備します。

バイナリービルドのソースディレクトリーを、ローカルファイルシステムと deployments/ サブディレクトリーに作成します。WAR アーカイブを deployments/ にコピーします。

[tomcat-websocket-chat]$ ls

pom.xml  README.md  src/  target/

$ mkdir -p ocp/deployments

$ cp target/websocket-chat.war ocp/deployments/

OpenShift インスタンスにログインします。

$ oc login <url>

必要に応じて新規プロジェクトを作成します。

$ oc new-project jws-bin-demo

oc get is -n openshift でアプリケーションに使用する OpenShift イメージストリームの JWS を特定します。

$ oc get is -n openshift | grep ^jboss-webserver | cut -f1 -d ' '

jboss-webserver50-tomcat9-openshift

イメージストリームおよびアプリケーション名を指定して、新規ビルド設定を作成します。

$ oc new-build --binary=true \
 --image-stream=jboss-webserver<version>-openjdk8-tomcat9-openshift-rhel8:latest\
 --name=jws-wsch-app

--> Found image 8c3b85b (4 weeks old) in image stream "openshift/jboss-webserver<version>-tomcat9-openshift" under tag "latest" for "jboss-webserver<version>"

    JBoss Web Server 5.0
    --------------------
    Platform for building and running web applications on JBoss Web Server 5.0 - Tomcat v9

    Tags: builder, java, tomcat9

    * A source build using binary input will be created
      * The resulting image will be pushed to image stream "jws-wsch-app:latest"
      * A binary build was created, use 'start-build --from-dir' to trigger a new build

--> Creating resources with label build=jws-wsch-app ...
    imagestream "jws-wsch-app" created
    buildconfig "jws-wsch-app" created
--> Success

バイナリービルドを開始します。OpenShift イメージビルドのバイナリー入力にソースディレクトリーを使用するように OpenShift に指示します。

$ *oc start-build jws-wsch-app --from-dir=./ocp --follow*

Uploading directory "ocp" as binary input for the build ...
build "jws-wsch-app-1" started
Receiving source from STDIN as archive ...

Copying all deployments war artifacts from /home/jboss/source/deployments directory into `/opt/jws-5.5/tomcat/webapps` for later deployment...
'/home/jboss/source/deployments/websocket-chat.war' -> '/opt/jws-5.5/tomcat/webapps/websocket-chat.war'

Pushing image 172.30.202.111:5000/jws-bin-demo/jws-wsch-app:latest ...
Pushed 0/7 layers, 7% complete
Pushed 1/7 layers, 14% complete
Pushed 2/7 layers, 29% complete
Pushed 3/7 layers, 49% complete
Pushed 4/7 layers, 62% complete
Pushed 5/7 layers, 92% complete
Pushed 6/7 layers, 100% complete
Pushed 7/7 layers, 100% complete
Push successful

イメージに基づいて新しい OpenShift アプリケーションを作成します。

$ oc new-app jws-wsch-app

--> Found image e5f3a6b (About a minute old) in image stream "jws-bin-demo/jws-wsch-app" under tag "latest" for "jws-wsch-app"

    JBoss Web Server 5.0
    --------------------
    Platform for building and running web applications on JBoss Web Server 5.0 - Tomcat v9

    Tags: builder, java, tomcat9

    * This image will be deployed in deployment config "jws-wsch-app"
    * Ports 8080/tcp, 8443/tcp, 8778/tcp will be load balanced by service "jws-wsch-app"
      * Other containers can access this service through the hostname "jws-wsch-app"

--> Creating resources ...
    deploymentconfig "jws-wsch-app" created
    service "jws-wsch-app" created
--> Success
    Application is not exposed. You can expose services to the outside world by executing one or more of the commands below:
     'oc expose svc/jws-wsch-app'
    Run 'oc status' to view your app.

サービスを公開して、アプリケーションがユーザーにアクセスできるようにします。

# to check the name of the service to expose
$ oc get svc -o name

service/jws-wsch-app

# to expose the service
$ oc expose svc/jws-wsch-app

route "jws-wsch-app" exposed

公開されたルートのアドレスを取得します。

oc get routes --no-headers -o custom-columns='host:spec.host' jws-wsch-app

これで、Operator のインストールを設定できるようになりました。以下の 3 つのオプションを指定します。

JWS Operator を検査し、以下のコマンドを使用して、サポートされる installMode および利用可能なチャネルを確認します。

$   oc get packagemanifests -n openshift-marketplace | grep jws
    jws-operator    Red Hat Operators   16h

$   oc describe packagemanifests jws-operator -n openshift-marketplace | grep "Catalog Source"
    Catalog Source:     redhat-operators

OperatorGroup は、OperatorGroup と同じ名前空間内のすべての Operator に必要な RBAC アクセスを生成するターゲット名前空間を選択する OLM リソースです。

Operator をサブスクライブする名前空間には、Operator の InstallMode に一致する OperatorGroup が必要になります (AllNamespaces または SingleNamespace モードのいずれか)。インストールする Operator が AllNamespaces を使用する場合は、openshift-operators 名前空間には適切な OperatorGroup がすでに配置されます。

ただし、Operator が SingleNamespace モードを使用する場合、1 つの OperatorGroup をその名前空間で作成する必要があります。OperatorGroup の実際の一覧を確認するには、以下のコマンドを使用します。

$ oc get operatorgroups -n <project_name>

OperatorGroup リストの出力例:

NAME       AGE
mygroup    17h

サブスクリプションオブジェクト YAML ファイルを作成します (例: jws-operator-sub.yaml)。Subscription オブジェクト YAML ファイルを以下のように設定します。

apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
    name: jws-operator
    namespace: <project_name>
spec:
    channel: alpha
    name: jws-operator
    source: redhat-operators
    sourceNamespace: openshift-marketplace

<project_name> は、オペレーター (oc project -q) をインストールするプロジェクトの名前空間であり、すべての名前空間で openshift-operators を使用するようになります。

source は Catalog Source です。これは、このセクションの手順 1 で実行した $ oc describe packagemanifests jws-operator -n openshift-marketplace | grep "Catalog Source:" コマンドの値です。この値は redhat-operators である必要があります。

以下のコマンドを使用して、YAML ファイルから Subscription オブジェクトを作成します。

$   oc apply -f jws-operator-sub.yaml

インストールが正常に行われたことを確認するには、以下のコマンドを実行します。

$   oc get csv -n <project_name>

以下のコマンドを使用して、currentCSV フィールドでサブスクライブされた Operator の現行バージョンを確認します。

$   oc get subscription jws-operator -n <project_name> -o yaml | grep currentCSV
    f:currentCSV: {}
    currentCSV: jws-operator.v1.0.0

以下のコマンドを使用してオペレーターのサブスクリプションを削除します。

$   oc delete subscription jws-operator -n <project_name>

以下のコマンドを使用して、直前の手順の currentCSV 値を使用して、ターゲット名前空間のオペレーターの CSV を削除します。

$   oc delete clusterserviceversion <currentCSV> -n <project_name>

ここで、<currentCSV> は、手順 1 で取得した値になります。

$   oc delete clusterserviceversion jws-operator.v1.0.0
    clusterserviceversion.operators.coreos.com "jws-operator.v1.0.0" deleted