Eclipse Vert.x ランタイムガイド

手順

1. ブラウザーで developers.redhat.com/launch URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで OpenShift Online URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して CLI クライアント oc を OpenShift Online アカウントで認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

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

   $ mvn clean oc:deploy -Popenshift

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

5. アプリケーションのステータスを確認し、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

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

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

   ルート情報の例

   $ 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

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

手順

1. Minishift または CDK を起動したコンソールに移動します。

2. 実行中の Launcher にアクセスするのに使用できる URL およびユーザー認証情報のコンソール出力を確認します。

   Minishift または CDK 起動時のコンソール出力の例

   ...
   -- Removing temporary directory ... OK
   -- Server Information ...
      OpenShift server started.
      The server is accessible via web console at:
          https://192.168.42.152:8443
   
      You are logged in as:
          User:     developer
          Password: developer
   
      To login as administrator:
          oc login -u system:admin

手順

1. ブラウザーで Launcher URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで Minishift または CDK URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して、Minishift または CDK アカウントで CLI クライアント oc を認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

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

   $ mvn clean oc:deploy -Popenshift

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

5. アプリケーションのステータスを確認し、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

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

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

   ルート情報の例

   $ 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

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

手順

1. ブラウザーで developers.redhat.com/launch URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで OpenShift Online URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して CLI クライアント oc を OpenShift Online アカウントで認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

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

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

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

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

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

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

   $ oc get configmap app-config -o yaml
   
   apiVersion: template.openshift.io/v1
   data:
     app-config.yml: |-
         message : "Hello, %s from a ConfigMap !"
         level : INFO
   ...

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

   $ mvn clean oc:deploy -Popenshift

   このコマンドは、OpenShift 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

   MY_APP_NAME-1-aaaaa Pod は、完全にデプロイされて起動すると、ステータスが Running になるはずです。また、続行する前に Pod が 準備状態 になるまで待機する必要があります。これは READY 列に表示されます。たとえば、 MY_APP_NAME-1-aaaaa は READY 列が 1/1 の場合に 準備状態 になります。特定の 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

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

手順

1. Minishift または CDK を起動したコンソールに移動します。

2. 実行中の Launcher にアクセスするのに使用できる URL およびユーザー認証情報のコンソール出力を確認します。

   Minishift または CDK 起動時のコンソール出力の例

   ...
   -- Removing temporary directory ... OK
   -- Server Information ...
      OpenShift server started.
      The server is accessible via web console at:
          https://192.168.42.152:8443
   
      You are logged in as:
          User:     developer
          Password: developer
   
      To login as administrator:
          oc login -u system:admin

手順

1. ブラウザーで Launcher URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで Minishift または CDK URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して、Minishift または CDK アカウントで CLI クライアント oc を認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

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

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

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

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

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

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

   $ oc get configmap app-config -o yaml
   
   apiVersion: template.openshift.io/v1
   data:
     app-config.yml: |-
         message : "Hello, %s from a ConfigMap !"
         level : INFO
   ...

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

   $ mvn clean oc:deploy -Popenshift

   このコマンドは、OpenShift 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

   MY_APP_NAME-1-aaaaa Pod は、完全にデプロイされて起動すると、ステータスが Running になるはずです。また、続行する前に Pod が 準備状態 になるまで待機する必要があります。これは READY 列に表示されます。たとえば、 MY_APP_NAME-1-aaaaa は READY 列が 1/1 の場合に 準備状態 になります。特定の 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

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

手順

1. ブラウザーで developers.redhat.com/launch URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで OpenShift Online URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して CLI クライアント oc を OpenShift Online アカウントで認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

4. PostgreSQL データベースを OpenShift にデプロイします。データベースアプリケーションの作成時に、ユーザー名、パスワード、データベース名に以下の値を使用するようにしてください。これらの値を使用するために、サンプルアプリケーションが事前設定されています。異なる値を使用すると、アプリケーションがデータベースと統合できなくなります。

   $ oc new-app -e POSTGRESQL_USER=luke -ePOSTGRESQL_PASSWORD=secret -ePOSTGRESQL_DATABASE=my_data registry.access.redhat.com/rhscl/postgresql-10-rhel7 --name=my-database

5. データベースのステータスを確認し、Pod が実行されていることを確認します。

   $ oc get pods -w
   my-database-1-aaaaa   1/1       Running   0         45s
   my-database-1-deploy   0/1       Completed   0         53s

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

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

   $ mvn clean oc:deploy -Popenshift

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

7. アプリケーションのステータスを確認し、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

   MY_APP_NAME-1-aaaaa Pod のステータスは Running で、完全にデプロイされて起動すると ready と示される必要があります。

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

   ルート情報の例

   $ 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

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

手順

1. Minishift または CDK を起動したコンソールに移動します。

2. 実行中の Launcher にアクセスするのに使用できる URL およびユーザー認証情報のコンソール出力を確認します。

   Minishift または CDK 起動時のコンソール出力の例

   ...
   -- Removing temporary directory ... OK
   -- Server Information ...
      OpenShift server started.
      The server is accessible via web console at:
          https://192.168.42.152:8443
   
      You are logged in as:
          User:     developer
          Password: developer
   
      To login as administrator:
          oc login -u system:admin

手順

1. ブラウザーで Launcher URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで Minishift または CDK URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して、Minishift または CDK アカウントで CLI クライアント oc を認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

4. PostgreSQL データベースを OpenShift にデプロイします。データベースアプリケーションの作成時に、ユーザー名、パスワード、データベース名に以下の値を使用するようにしてください。これらの値を使用するために、サンプルアプリケーションが事前設定されています。異なる値を使用すると、アプリケーションがデータベースと統合できなくなります。

   $ oc new-app -e POSTGRESQL_USER=luke -ePOSTGRESQL_PASSWORD=secret -ePOSTGRESQL_DATABASE=my_data registry.access.redhat.com/rhscl/postgresql-10-rhel7 --name=my-database

5. データベースのステータスを確認し、Pod が実行されていることを確認します。

   $ oc get pods -w
   my-database-1-aaaaa   1/1       Running   0         45s
   my-database-1-deploy   0/1       Completed   0         53s

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

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

   $ mvn clean oc:deploy -Popenshift

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

7. アプリケーションのステータスを確認し、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

   MY_APP_NAME-1-aaaaa Pod のステータスは Running で、完全にデプロイされて起動すると ready と示される必要があります。

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

   ルート情報の例

   $ 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

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

手順

1. ブラウザーで developers.redhat.com/launch URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで OpenShift Online URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して CLI クライアント oc を OpenShift Online アカウントで認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

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

   $ mvn clean oc:deploy -Popenshift

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

5. アプリケーションのステータスを確認し、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

   MY_APP_NAME-1-aaaaa Pod は、完全にデプロイされて起動すると、ステータスが Running である必要があります。また、続行する前に Pod が準備状態になるまで待機する必要があります。これは READY 列に表示されます。たとえば、MY_APP_NAME-1-aaaaa は、READY 列が 1/1 の場合に準備状態になります。特定の Pod 名が異なります。中間の数字は新しいビルドごとに増えます。末尾の文字は、Pod の作成時に生成されます。

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

   ルート情報の例

   $ 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

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

手順

1. Minishift または CDK を起動したコンソールに移動します。

2. 実行中の Launcher にアクセスするのに使用できる URL およびユーザー認証情報のコンソール出力を確認します。

   Minishift または CDK 起動時のコンソール出力の例

   ...
   -- Removing temporary directory ... OK
   -- Server Information ...
      OpenShift server started.
      The server is accessible via web console at:
          https://192.168.42.152:8443
   
      You are logged in as:
          User:     developer
          Password: developer
   
      To login as administrator:
          oc login -u system:admin

手順

1. ブラウザーで Launcher URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで Minishift または CDK URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して、Minishift または CDK アカウントで CLI クライアント oc を認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

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

   $ mvn clean oc:deploy -Popenshift

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

5. アプリケーションのステータスを確認し、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

   MY_APP_NAME-1-aaaaa Pod は、完全にデプロイされて起動すると、ステータスが Running である必要があります。また、続行する前に Pod が準備状態になるまで待機する必要があります。これは READY 列に表示されます。たとえば、MY_APP_NAME-1-aaaaa は、READY 列が 1/1 の場合に準備状態になります。特定の Pod 名が異なります。中間の数字は新しいビルドごとに増えます。末尾の文字は、Pod の作成時に生成されます。

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

   ルート情報の例

   $ 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

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

手順

1. ブラウザーで developers.redhat.com/launch URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで OpenShift Online URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して CLI クライアント oc を OpenShift Online アカウントで認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

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

   $ mvn clean oc:deploy -Popenshift

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

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

   $ oc get pods -w
   NAME                             READY     STATUS      RESTARTS   AGE
   MY_APP_NAME-greeting-1-aaaaa     1/1       Running   0           17s
   MY_APP_NAME-greeting-1-deploy    0/1       Completed 0           22s
   MY_APP_NAME-name-1-aaaaa         1/1       Running   0           14s
   MY_APP_NAME-name-1-deploy        0/1       Completed 0           28s

   完全にデプロイされて起動すると、MY_APP_NAME-greeting-1-aaaaa Pod と MY_APP_NAME-name-1-aaaaa Pod の両方のステータスが Running となります。また、続行する前に Pod が準備状態になるまで待機する必要があります。これは READY 列に表示されます。たとえば、MY_APP_NAME-greeting-1-aaaaa は、READY 列が 1/1 の場合に準備状態になります。特定の Pod 名が異なります。中間の数字は新しいビルドごとに増えます。末尾の文字は、Pod の作成時に生成されます。

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

   ルート情報の例

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

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

手順

1. Minishift または CDK を起動したコンソールに移動します。

2. 実行中の Launcher にアクセスするのに使用できる URL およびユーザー認証情報のコンソール出力を確認します。

   Minishift または CDK 起動時のコンソール出力の例

   ...
   -- Removing temporary directory ... OK
   -- Server Information ...
      OpenShift server started.
      The server is accessible via web console at:
          https://192.168.42.152:8443
   
      You are logged in as:
          User:     developer
          Password: developer
   
      To login as administrator:
          oc login -u system:admin

手順

1. ブラウザーで Launcher URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで Minishift または CDK URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して、Minishift または CDK アカウントで CLI クライアント oc を認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

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

   $ mvn clean oc:deploy -Popenshift

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

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

   $ oc get pods -w
   NAME                             READY     STATUS      RESTARTS   AGE
   MY_APP_NAME-greeting-1-aaaaa     1/1       Running   0           17s
   MY_APP_NAME-greeting-1-deploy    0/1       Completed 0           22s
   MY_APP_NAME-name-1-aaaaa         1/1       Running   0           14s
   MY_APP_NAME-name-1-deploy        0/1       Completed 0           28s

   完全にデプロイされて起動すると、MY_APP_NAME-greeting-1-aaaaa Pod と MY_APP_NAME-name-1-aaaaa Pod の両方のステータスが Running となります。また、続行する前に Pod が準備状態になるまで待機する必要があります。これは READY 列に表示されます。たとえば、MY_APP_NAME-greeting-1-aaaaa は、READY 列が 1/1 の場合に準備状態になります。特定の Pod 名が異なります。中間の数字は新しいビルドごとに増えます。末尾の文字は、Pod の作成時に生成されます。

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

   ルート情報の例

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

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

手順

1. Minishift または CDK を起動したコンソールに移動します。

2. 実行中の Launcher にアクセスするのに使用できる URL およびユーザー認証情報のコンソール出力を確認します。

   Minishift または CDK 起動時のコンソール出力の例

   ...
   -- Removing temporary directory ... OK
   -- Server Information ...
      OpenShift server started.
      The server is accessible via web console at:
          https://192.168.42.152:8443
   
      You are logged in as:
          User:     developer
          Password: developer
   
      To login as administrator:
          oc login -u system:admin

手順

1. ブラウザーで Minishift または CDK URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して、Minishift または CDK アカウントで CLI クライアント oc を認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

4. サンプル ZIP ファイルから service.sso.yaml ファイルを使用して Red Hat SSO サーバーをデプロイします。

   $ oc create -f service.sso.yaml

5. Maven を使用して、Minishift または CDK にデプロイメントを開始します。

   $ mvn clean oc:deploy -Popenshift -DskipTests \
         -DSSO_AUTH_SERVER_URL=$(oc get route secure-sso -o jsonpath='{"https://"}{.spec.host}{"/auth\n"}')

   このコマンドは、OpenShift Maven Plugin を使用して Minishift または CDK で S2I プロセス を起動し、Pod を起動します。

手順

1. ブラウザーで OpenShift Container Platform URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して CLI クライアント oc を OpenShift Container Platform アカウントで認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

4. サンプル ZIP ファイルから service.sso.yaml ファイルを使用して Red Hat SSO サーバーをデプロイします。

   $ oc create -f service.sso.yaml

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

   $ mvn clean oc:deploy -Popenshift -DskipTests \
         -DSSO_AUTH_SERVER_URL=$(oc get route secure-sso -o jsonpath='{"https://"}{.spec.host}{"/auth\n"}')

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

手順

1. 端末アプリケーションで、oc get routes コマンドを実行します。

   以下の表の出力例を以下に示します。

   例7.1 Secured エンドポイントの一覧

   Expand

   名前	ホスト/ポート	パス	サービス	ポート	終了
   secure-sso	secure-sso-myproject.LOCAL_OPENSHIFT_HOSTNAME		secure-sso	(すべて)	passthrough
   PROJECT_ID	PROJECT_ID-myproject.LOCAL_OPENSHIFT_HOSTNAME		PROJECT_ID	(すべて)
   sso	sso-myproject.LOCAL_OPENSHIFT_HOSTNAME		sso	(すべて)

   Show more

   上記の例では、エンドポイントは http://PROJECT_ID-myproject.LOCAL_OPENSHIFT_HOSTNAME になります。PROJECT_ID は、developers.redhat.com/launch または Launcher ツールを使用してサンプルを生成する際に入力した名前に基づいています。

手順

1. curl、認証情報、<SSO_AUTH_SERVER_URL> でアクセストークンを要求し、jq コマンドを使用して応答からトークンを展開します。

   curl -sk -X POST https://<SSO_AUTH_SERVER_URL>/auth/realms/master/protocol/openid-connect/token \
     -d grant_type=password \
     -d username=alice\
     -d password=password \
     -d client_id=demoapp \
     -d client_secret=1daa57a2-b60e-468b-a3ac-25bd2dc2eadc \
     | jq -r '.access_token'
   
   eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJRek1nbXhZMUhrQnpxTnR0SnkwMm5jNTNtMGNiWDQxV1hNSTU1MFo4MGVBIn0.eyJqdGkiOiI0NDA3YTliNC04YWRhLTRlMTctODQ2ZS03YjI5MjMyN2RmYTIiLCJleHAiOjE1MDc3OTM3ODcsIm5iZiI6MCwiaWF0IjoxNTA3NzkzNzI3LCJpc3MiOiJodHRwczovL3NlY3VyZS1zc28tc3NvLWRlbW8uYXBwcy5jYWZlLWJhYmUub3JnL2F1dGgvcmVhbG1zL21hc3RlciIsImF1ZCI6ImRlbW9hcHAiLCJzdWIiOiJjMDE3NWNjYi0wODkyLTRiMzEtODI5Zi1kZGE4NzM4MTVmZTgiLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiJkZW1vYXBwIiwiYXV0aF90aW1lIjowLCJzZXNzaW9uX3N0YXRlIjoiMDFjOTkzNGQtNmZmOS00NWYzLWJkNWUtMTU4NDI5ZDZjNDczIiwiYWNyIjoiMSIsImNsaWVudF9zZXNzaW9uIjoiMzM3Yzk0MTYtYTdlZS00ZWUzLThjZWQtODhlODI0MGJjNTAyIiwiYWxsb3dlZC1vcmlnaW5zIjpbIioiXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbImJvb3N0ZXItYWRtaW4iXX0sInJlc291cmNlX2FjY2VzcyI6eyJzZWN1cmVkLWJvb3N0ZXItZW5kcG9pbnQiOnsicm9sZXMiOlsiYm9vc3Rlci1hZG1pbiJdfSwiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsInZpZXctcHJvZmlsZSJdfX0sIm5hbWUiOiJBbGljZSBJbkNoYWlucyIsInByZWZlcnJlZF91c2VybmFtZSI6ImFsaWNlIiwiZ2l2ZW5fbmFtZSI6IkFsaWNlIiwiZmFtaWx5X25hbWUiOiJJbkNoYWlucyIsImVtYWlsIjoiYWxpY2VAa2V5Y2xvYWsub3JnIn0.mjmZe37enHpigJv0BGuIitOj-kfMLPNwYzNd3n0Ax4Nga7KpnfytGyuPSvR4KAG8rzkfBNN9klPYdy7pJEeYlfmnFUkM4EDrZYgn4qZAznP1Wzy1RfVRdUFi0-GqFTMPb37o5HRldZZ09QljX_j3GHnoMGXRtYW9RZN4eKkYkcz9hRwgfJoTy2CuwFqeJwZYUyXifrfA-JoTr0UmSUed-0NMksGrtJjjPggUGS-qOn6OgKcmN2vaVAQlxW32y53JqUXctfLQ6DhJzIMYTmOflIPy0sgG1mG7sovQhw1xTg0vTjdx8zQ-EJcexkj7IivRevRZsslKgqRFWs67jQAFQA

   <SSO_AUTH_SERVER_URL> は secure-sso サービスの URL です。

   username、password、client_secret などの属性は、通常、秘密になりますが、上記のコマンドはこの例で提供されているデフォルトの認証情報をデモの目的で使用します。

   jq を使用してトークンを抽出しない場合は、curl コマンドのみを実行し、アクセストークンを手動で抽出できます。

   注記

   -sk オプションは curl に対し、自己署名証明書の失敗を無視します。実稼働環境ではこのオプションを使用しないでください。macOS では、curl バージョン 7.56.1 以降がインストールされている必要があります。また、OpenSSL でビルドする必要があります。

1. Secured サービスを起動します。アクセス (ベアラー) トークンを HTTP ヘッダーに割り当てます。

   $ curl -v -H "Authorization: Bearer <TOKEN>" http://<SERVICE_HOST>/api/greeting
   
   {
       "content": "Hello, World!",
       "id": 2
   }

   例7.2 Access (Bearer) トークンが含まれる GET 要求ヘッダーのサンプル

   > GET /api/greeting HTTP/1.1
   > Host: <SERVICE_HOST>
   > User-Agent: curl/7.51.0
   > Accept: */*
   > Authorization: Bearer <TOKEN>

   <SERVICE_HOST> は、セキュアなサンプルエンドポイントの URL です。詳細は「Secured サンプルアプリケーション API エンドポイントの取得」を参照してください。

2. アクセストークンの署名を確認します。

   アクセストークンは JSON Web トークン であるため、JWT デバッガー を使用してデコードできます。

   1. Web ブラウザーで、JWT デバッガー の Web サイトに移動します。

   2. Algorithm ドロップダウンメニューから RS256 を選択します。

      注記

      選択後に Web フォームが更新され、正しい RSASHA256(…​) 情報が Signature セクションに表示されることを確認します。そうでない場合は、HS256 に切り替えてから RS256 に戻ります。

   3. 上部のテキストボックスの VERIFY SIGNATURE セクションに以下のコンテンツを貼り付けます。

      -----BEGIN PUBLIC KEY-----
      MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoETnPmN55xBJjRzN/cs30OzJ9olkteLVNRjzdTxFOyRtS2ovDfzdhhO9XzUcTMbIsCOAZtSt8K+6yvBXypOSYvI75EUdypmkcK1KoptqY5KEBQ1KwhWuP7IWQ0fshUwD6jI1QWDfGxfM/h34FvEn/0tJ71xN2P8TI2YanwuDZgosdobx/PAvlGREBGuk4BgmexTOkAdnFxIUQcCkiEZ2C41uCrxiS4CEe5OX91aK9HKZV4ZJX6vnqMHmdDnsMdO+UFtxOBYZio+a1jP4W3d7J5fGeiOaXjQCOpivKnP2yU2DPdWmDMyVb67l8DRA+jh0OJFKZ5H2fNgE3II59vdsRwIDAQAB
      -----END PUBLIC KEY-----

      注記

      これは、Secured サンプルアプリケーションの Red Hat SSO サーバーデプロイメントからのマスターレルム公開鍵です。

   4. クライアント出力から Encoded ボックスに token の出力を貼り付けます。

      Signature Verified 記号がデバッガーページに表示されます。

手順

1. Web ブラウザーで、エンドポイント URL に移動します。

2. 認証されていない要求を実行します。

   1. Invoke ボタンをクリックします。

      図7.1 認証されていないセキュアなサンプル Web インターフェイス

      

      サービスは、HTTP 401 Unauthorized ステータスコードで応答します。

      図7.2 認証されていないエラーメッセージ

      

3. 認証された要求をユーザーとして実行します。

   1. Login ボタンをクリックして Red Hat SSO に対して認証を行います。SSO サーバーにリダイレクトされます。

   2. Alice ユーザー としてログインします。Web インターフェイスにリダイレクトされます。

      注記

      ページ下部のコマンドライン出力に、アクセス (ベアラー) トークンが表示されます。

      図7.3 (Alice として) 認証されたセキュアなサンプル Web インターフェイス

      

   3. 再度 Invoke をクリックして Greeting サービスにアクセスします。

      例外がなく、JSON 応答ペイロードが表示されていることを確認します。これは、サービスがアクセス (ベアラー) トークンを受け入れ、Greeting サービスへのアクセスが承認されていることを意味します。

      図7.4 (Alice として) 認証された Greeting リクエストの結果

      
   4. ログアウトします。

4. 認証された要求を管理者として実行します。

   1. Invoke ボタンをクリックします。

      これにより、認証されていない要求が Greeting サービスに送信されていることを確認します。

   2. Login ボタンをクリックして admin ユーザー としてログインします。

      図7.5 (admin として) 認証されたセキュアなサンプル Web インターフェイス

      

5. Invoke ボタンをクリックします。

   このサービスは、admin ユーザーが Greeting サービスへのアクセスが許可されていないため、HTTP 403 Forbidden ステータスコードで応答します。

   図7.6 承認されていないエラーメッセージ

   

手順

1. ブラウザーで developers.redhat.com/launch URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで OpenShift Online URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して CLI クライアント oc を OpenShift Online アカウントで認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

4. キャッシュサービスをデプロイします。

   $ oc apply -f service.cache.yml

   注記

   x86_64 以外のアーキテクチャーを使用している場合は、YAML ファイルで Red Hat Data Grid のイメージ名を、そのアーキテクチャー内の関連するイメージ名に更新します。たとえば、s390x または ppc64le アーキテクチャーの場合は、イメージ名を IBM Z または IBM Power Systems のイメージ名 registry.access.redhat.com/jboss-datagrid-7/datagrid73-openj9-11-openshift-rhel8 に更新します。

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

   $ mvn clean oc:deploy -Popenshift

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

   $ oc get pods -w
   NAME                             READY     STATUS      RESTARTS   AGE
   cache-server-123456789-aaaaa             1/1       Running     0          8m
   MY_APP_NAME-cutename-1-bbbbb       1/1       Running     0          4m
   MY_APP_NAME-cutename-s2i-1-build   0/1       Completed   0          7m
   MY_APP_NAME-greeting-1-ccccc       1/1       Running     0          3m
   MY_APP_NAME-greeting-s2i-1-build   0/1       Completed   0          3m

   3 つの Pod が完全にデプロイされて起動すると、ステータスは Running になります。

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

   ルート情報の例

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

   Pod のルート情報は、アクセスに使用するベース URL を提供します。上記の例では、http://MY_APP_NAME-greeting-MY_PROJECT_NAME.OPENSHIFT_HOSTNAME をベース URL として使用し、greeting サービスにアクセスします。

手順

1. Minishift または CDK を起動したコンソールに移動します。

2. 実行中の Launcher にアクセスするのに使用できる URL およびユーザー認証情報のコンソール出力を確認します。

   Minishift または CDK 起動時のコンソール出力の例

   ...
   -- Removing temporary directory ... OK
   -- Server Information ...
      OpenShift server started.
      The server is accessible via web console at:
          https://192.168.42.152:8443
   
      You are logged in as:
          User:     developer
          Password: developer
   
      To login as administrator:
          oc login -u system:admin

手順

1. ブラウザーで Launcher URL に移動します。
2. 画面上の指示に従って、Eclipse Vert.x でアプリケーションのサンプルを作成して起動します。

手順

1. ブラウザーで Minishift または CDK URL に移動します。
2. ユーザー名の横にある Web コンソールの右上にあるクエスチャルマークアイコンをクリックします。
3. ドロップダウンメニューで Command Line Tools を選択します。
4. oc login コマンドをコピーします。

5. 端末にコマンドを貼り付けます。このコマンドは、認証トークンを使用して、Minishift または CDK アカウントで CLI クライアント oc を認証します。

   $ oc login OPENSHIFT_URL --token=MYTOKEN

手順

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

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

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

   $ unzip MY_PROJECT_NAME.zip

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

   $ oc new-project MY_PROJECT_NAME

3. アプリケーションの root ディレクトリーに移動します。

4. キャッシュサービスをデプロイします。

   $ oc apply -f service.cache.yml

   注記

   x86_64 以外のアーキテクチャーを使用している場合は、YAML ファイルで Red Hat Data Grid のイメージ名を、そのアーキテクチャー内の関連するイメージ名に更新します。たとえば、s390x または ppc64le アーキテクチャーの場合は、イメージ名を IBM Z または IBM Power Systems のイメージ名 registry.access.redhat.com/jboss-datagrid-7/datagrid73-openj9-11-openshift-rhel8 に更新します。

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

   $ mvn clean oc:deploy -Popenshift

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

   $ oc get pods -w
   NAME                             READY     STATUS      RESTARTS   AGE
   cache-server-123456789-aaaaa             1/1       Running     0          8m
   MY_APP_NAME-cutename-1-bbbbb       1/1       Running     0          4m
   MY_APP_NAME-cutename-s2i-1-build   0/1       Completed   0          7m
   MY_APP_NAME-greeting-1-ccccc       1/1       Running     0          3m
   MY_APP_NAME-greeting-s2i-1-build   0/1       Completed   0          3m

   3 つの Pod が完全にデプロイされて起動すると、ステータスは Running になります。

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

   ルート情報の例

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

   Pod のルート情報は、アクセスに使用するベース URL を提供します。上記の例では、http://MY_APP_NAME-greeting-MY_PROJECT_NAME.OPENSHIFT_HOSTNAME をベース URL として使用し、greeting サービスにアクセスします。