第3章 アプリケーションの作成

手順

1. +Add ビューで、Samples タイルをクリックし、Samples ページを表示します。
2. Samples ページで、利用可能なサンプルアプリケーションの 1 つを選択し、Create Sample Application フォームを表示します。

3. Create Sample Application Form:

   • Name フィールドには、デフォルトでデプロイメント名が表示されます。この名前は必要に応じて変更することができます。
   • Builder Image Version では、ビルダーイメージがデフォルトで選択されます。Builder Image Version ドロップダウンリストを使用してイメージバージョンを変更できます。
   • Git リポジトリー URL のサンプルは、デフォルトで追加されます。
4. Create をクリックしてサンプルアプリケーションを作成します。サンプルアプリケーションのビルドステータスが Topology ビューに表示されます。サンプルアプリケーションの作成後、デプロイメントがアプリケーションに追加されていることを確認できます。

手順

1. +Add ビューで、Git Repository タイルの From Git をクリックし、Import from git フォームを表示します。
2. Git セクションで、アプリケーションの作成に使用するコードベースの Git リポジトリー URL を入力します。たとえば、このサンプル nodejs アプリケーションの URL https://github.com/sclorg/nodejs-ex を入力します。その後、URL は検証されます。

3. オプション: Show Advanced Git Options をクリックし、以下のような詳細を追加できます。

   • Git Reference: アプリケーションのビルドに使用する特定のブランチ、タグ、またはコミットのコードを参照します。
   • Context Dir: アプリケーションのビルドに使用するアプリケーションのソースコードのサブディレクトリーを指定します。
   • Source Secret: プライベートリポジトリーからソースコードをプルするための認証情報で Secret Name を作成します。

4. オプション: Git リポジトリーを使用して devfile、Dockerfile、またはビルダーイメージをインポートして、デプロイメントをさらにカスタマイズできるようになりました。

   • Git リポジトリーに devfile、Dockerfile、またはビルダーイメージが含まれる場合には、これらは自動的に検出され、それぞれのパスフィールドに設定されます。devfile、Dockerfile、およびビルダーイメージが同じリポジトリーで検出されると、devfile はデフォルトで選択されます。
   • ファイルのインポートタイプを編集して、別のストラテジーを選択し、Edit import strategy オプションをクリックします。
   • 複数の devfile、Dockerfile、またはビルダーイメージを検出された場合に、特定の devfile、Dockerfile、またはビルダーイメージをインポートするにはコンテキストディレクトリーを起点とした相対パスを指定します。

5. Git URL の検証後に、推奨されるビルダーイメージが選択されて星マークが付けられます。ビルダーイメージが自動検出されていない場合は、ビルダーイメージを選択します。https://github.com/sclorg/nodejs-ex Git URL の場合、Node.js ビルダーイメージがデフォルトで選択されます。

   1. オプション:Builder Image Version ドロップダウンリストを使用してバージョンを指定します。
   2. オプション:Edit import strategy を使用して、別のストラテジーを選択します。

6. General セクションで、以下を実行します。

   1. Application フィールドに、アプリケーションを分類するために一意の名前 (myapp など) を入力します。アプリケーション名が namespace で一意であることを確認します。

   2. Name フィールドで、既存のアプリケーションが存在しない場合に、このアプリケーション用に作成されたリソースが Git リポジトリー URL をベースとして自動的に設定されることを確認します。既存のアプリケーションがある場合には、既存のアプリケーション内でそのコンポーネントをデプロイしたり、新しいアプリケーションを作成したり、またはコンポーネントをいずれにも割り当てない状態にしたりすることができます。

      注記

      リソース名は namespace で一意である必要があります。エラーが出る場合はリソース名を変更します。

7. Resources セクションで、以下を選択します。

   • Deployment: 単純な Kubernetes スタイルのアプリケーションを作成します。
   • Deployment Config: OpenShift Container Platform スタイルのアプリケーションを作成します。

   • Serverless Deployment: Knative サービスを作成します。

     注記

     Serverless Deployment オプションは、Serverless Operator がクラスターにインストールされている場合にのみ、Import from git フォームに表示されます。詳細は、OpenShift Serverless のドキュメントを参照してください。

8. Pipelines セクションで、 Add Pipeline を選択してから Show Pipeline Visualization をクリックし、アプリケーションのパイプラインを表示します。
9. Advanced Options セクションでは、Create a route to the application がデフォルトで選択されるため、公開されている URL を使用してアプリケーションにアクセスできます。アプリケーションをパブリックルートに公開したくない場合は、チェックボックスをクリアできます。
10. オプション: 以下の高度なオプションを使用してアプリケーションをさらにカスタマイズできます。

手順

1. Topology ビューで、Topology ビューの任意の場所を右クリックし、Add to Project メニューを表示します。
2. Add to Project メニューにカーソルを置いてメニューオプションを表示し、Upload JAR ファイルオプションを選択し、 Upload JAR file オプションを選択して Upload JAR file フォームを確認します。または、Topology ビューで JAR ファイルをドラッグアンドドロップすることもできます。
3. JAR file フィールドで、ローカルマシンで必要な JAR ファイルを参照し、これをアップロードします。または、JAR ファイルをフィールドにドラッグアンドドロップすることもできます。互換性のないファイルタイプが Topology ビューでドラッグアンドドロップされると、トーストアラートが右側に表示されます。互換性のないファイルタイプがアップロードフォームのフィールドにドロップされると、フィールドエラーが表示されます。
4. オプションの Java コマンドをさらに指定して、デプロイされたアプリケーションをカスタマイズできます。ランタイムアイコンおよびビルダーイメージはデフォルトで選択されます。ビルダーイメージが自動検出されていない場合は、ビルダーイメージを選択します。必要に応じて、Builder Image Version のドロップダウンリストを使用してバージョンを変更できます。
5. オプションの Application Name フィールドに、リソースラベルリング用にアプリケーションの一意の名前を入力します。
6. Name フィールドに、関連付けられたリソースに名前を付けるために一意のコンポーネント名を入力します。
7. Resources フィールドで、アプリケーションのリソースタイプを選択します。
8. Advanced options で、Create a Route to the Application をクリックし、デプロイされたアプリケーションのパブリック URL を設定します。

9. Create をクリックしてアプリケーションをデプロイします。ユーザーは JAR ファイルがアップロード中であり、しばらくかかることを通知するトースト通知を確認します。トースト通知には、ビルドログを表示するリンクも含まれます。

   注記

   ユーザーがビルドの実行中にブラウザータブを閉じようとすると、ユーザーに Web アラートはページを実際に出るかどうかについて尋ねます。

手順

1. Developer パースペクティブで、+Add に移動して、Developer Catalog タイルから All Services をクリックし、Developer Catalog で利用可能なすべてのサービスを表示します。
2. All Services で、サービスの種類またはプロジェクトに追加する必要のあるコンポーネントを選択します。この例では、Databases を選択してすべてのデータベースサービスを一覧表示し、MariaDB をクリックしてサービスの詳細を表示します。

3. Instantiate Template をクリックして、MariaDB サービスの詳細情報を含む自動的に設定されたテンプレートを表示し、Create をクリックして Topology ビューで MariaDB サービスを作成し、これを表示します。

   図3.1 トポロジーの MariaDB