9.2.3.3. CLI クライアント oc を使用した Externalized Configuration アプリケーションのデプロイメント

手順

1. GitHub からプロジェクトのクローンを作成します。

   $ git clone git@github.com:USERNAME/MY_PROJECT_NAME.git

   Copy to Clipboard Toggle word wrap

   または、プロジェクトの ZIP ファイルをダウンロードして、展開します。

   $ unzip MY_PROJECT_NAME.zip

   Copy to Clipboard Toggle word wrap

2. 新しい OpenShift プロジェクトを作成します。

   $ oc new-project MY_PROJECT_NAME

   Copy to Clipboard Toggle word wrap

3. サンプルアプリケーションをデプロイする前に、サービスアカウントへの view アクセス権を割り当て、ConfigMap の内容を読み取るためにアプリケーションが OpenShift API にアクセスできるようにします。

   $ oc policy add-role-to-user view -n $(oc project -q) -z default

   Copy to Clipboard Toggle word wrap
4. アプリケーションの root ディレクトリーに移動します。

5. application.yml を使用して ConfigMap 設定を OpenShift にデプロイします。

   $ oc create configmap app-config --from-file=application.yml

   Copy to Clipboard Toggle word wrap

6. ConfigMap 設定がデプロイされていることを確認します。

   $ oc get configmap app-config -o yaml
   
   apiVersion: template.openshift.io/v1
   data:
     application.yml: |
        # This properties file should be used to initialise a ConfigMap
        greeting:
          message: "Hello %s from a ConfigMap!"
   ...

   Copy to Clipboard Toggle word wrap

7. Maven を使用して OpenShift へのデプロイメントを開始します。

   $ mvn clean fabric8:deploy -Popenshift

   Copy to Clipboard Toggle word wrap

   このコマンドは、Fabric8 Maven プラグインを使用して OpenShift で S2I プロセス を起動し、Pod を起動します。

8. アプリケーションのステータスを確認し、Pod が実行していることを確認します。

   $ oc get pods -w
   NAME                                       READY     STATUS      RESTARTS   AGE
   MY_APP_NAME-1-aaaaa               1/1       Running     0          58s
   MY_APP_NAME-s2i-1-build           0/1       Completed   0          2m

   Copy to Clipboard Toggle word wrap

   MY_APP_NAME-1-aaaaa Pod は、完全にデプロイされて起動すると、ステータスが Running である必要があります。特定の Pod 名が異なります。中間の数字は新規ビルドごとに増えます。末尾の文字は、Pod の作成時に生成されます。

9. アプリケーションのサンプルをデプロイして起動すると、そのルートを決定します。

   ルート情報の例

   $ oc get routes
   NAME                 HOST/PORT                                                     PATH      SERVICES        PORT      TERMINATION
   MY_APP_NAME         MY_APP_NAME-MY_PROJECT_NAME.OPENSHIFT_HOSTNAME      MY_APP_NAME      8080

   Copy to Clipboard Toggle word wrap

   Pod のルート情報には、アクセスに使用するベース URL が提供されます。上記の例では、http://MY_APP_NAME-MY_PROJECT_NAME.OPENSHIFT_HOSTNAME をベース URL として使用し、アプリケーションにアクセスします。