Red Hat SummitCodeReady Studio ツールのスタートガイド
Red Hat CodeReady Studio ツールの使用方法
概要
多様性を受け入れるオープンソースの強化
Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。これは大規模な取り組みであるため、これらの変更は今後の複数のリリースで段階的に実施されます。詳細は、弊社 の CTO、Chris Wright のメッセージ を参照してください。
第1章 CodeReady Studio の Git の基本
CodeReady Studio には、開発者がグラフィカルインターフェースから Git リポジトリーを管理できる Git Perspective が含まれています。ここでは、Git Perspective における Git プロジェクトの基本ワークフローの概要と、最も一般的な Git 関連のタスクを実行する方法を説明します。
1.1. Git Perspective の設定
CodeReady Studio で Git Perspective を開く方法を説明します。
手順
- CodeReady Studio を起動します。
→ → → とクリックします。
Open Perspective ウィンドウが表示されます。
- Git を選択します。
をクリックします。
Git Repositories ビューが表示されます。
1.2. Git Perspective でのリポジトリーの管理
1.2.1. 新規 Git リポジトリーの作成
Git Perspective を使用して新規 Git リポジトリーを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
- Git Perspective を開きます。
Create a new Git Repository and add it to this view アイコンをクリックします。
Create a Git Repository ウィンドウが表示されます。
デフォルトの Repository ディレクトリー へのパスが自動的に生成されます。リポジトリーの保存先へのパスを選択し、リポジトリーの作成を続行します。
必要に応じて、Create as bare repository チェックボックスを選択します。
注記ベアリポジトリーは中央リポジトリーに推奨されますが、開発環境には推奨されません。ベアリポジトリーには、ソースファイルの作業用のコピーや、チェックアウトされたコピーが含まれません。そのため、ファイルの編集や変更のコミットができません。さらに、リポジトリーの Git リビジョンの履歴は、
.gitサブフォルダーではなく、rootフォルダーに保存されます。をクリックします。
新しい Git リポジトリーがローカルマシンに作成され、Git Repositories ビューに表示されます。
1.2.2. 既存のローカル Git リポジトリーの追加
Git Perspective を使用して、ローカル Git リポジトリーを CodeReady Studio に追加する方法を説明します。
手順
- CodeReady Studio を起動します。
- Git Perspective を開きます。
Add an existing local Git Repository to this view アイコンをクリックします。
Add Git Repositories ウィンドウが表示されます。
をクリックして、ローカルの Git リポジトリーを見つけます。
-
Search results フィールドで、
.gitファイルへのパスを表示するチェックボックスを選択します。 - をクリックします。
ローカルリポジトリーが Git Repositories ビューに表示されます。
1.2.3. 既存の Git リポジトリーのクローン作成
Git Perspective を使用して、オンラインにすでに存在するリポジトリー (GitHub、GitLab) のローカルクローンを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
- Git Perspective を開きます。
Clone a Git Repository and add the clone to this view アイコンをクリックします。
Clone Git Repository ウィンドウが表示されます。
ソースリポジトリーのアドレスを URI フィールドに追加します。
Host および Repository path フィールドが自動的に入力されます。
- をクリックします。
- クローンを作成するブランチを選択します。
- をクリックします。
Directory パスとInitial branch が正しく設定されていることを確認してください。
- をクリックします。
クローンしたリポジトリーが、CodeReady Studio の Git Repository ビューに表示されます。
1.2.4. リポジトリーのリモートの追加
Git Perspective にリポジトリーを設定したら、リポジトリーにリモートを追加します。これは、新たに作成または追加されたリポジトリーに 1 度だけ必要な設定ステップです。
Git Perspective を使用してリポジトリーにリモートを設定する方法を説明します。
手順
- CodeReady Studio を起動します。
- Git Perspective を開きます。
リポジトリーを展開します。
→ と右クリックします。
New Remote ウインドウが表示されます。
- リモートに名前を付けます。
- Configure push が選択されていることを確認します。
をクリックします。
Configure Push ウィンドウが表示されます。
をクリックします。
Select a URI ウィンドウが表示されます。
ソースリポジトリーの URI、ユーザー名、およびパスワードを追加します。
Host および Repository パスフィールドが自動的に入力されます。
- をクリックします。
- をクリックします。
新たに追加されたリモートが、CodeReady Studio の Git Repositories ビューに表示されます。
1.3. Git Perspective でのブランチの管理
1.3.1. 新規ブランチの作成
Git パースペクティブを使用して新規ブランチを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
- Git Perspective を開きます。
- リポジトリーを展開して、すべてのリモートブランチを表示します。
→ と右クリックします。
Create Branch ウインドウが表示されます。
- をクリックして、新規ブランチのソースを選択します。
- ブランチに名前を付けます。
- Configure upstream for push and pull および Checkout new branch チェックボックスを選択します。
- When pulling フィールドで、必要なオプションを選択します。
- をクリックします。
新たに追加されたブランチが、CodeReady Studio の Git Repositories ビューに表示されます。
1.3.2. ブランチの使用
Git Perspective で埋め込みのターミナルを開き、作成したブランチを使用する方法を説明します。
手順
- CodeReady Studio を起動します。
- Git Perspective を開きます。
Shift+Ctrl+Alt+T キーを押します。
Launch Terminal ウインドウが表示されます。
- Local Terminal を選択します。
- Encoding を Default (ISO-8859-1) に設定します。
をクリックします。
Terminal ウインドウにコマンドラインターミナルが表示されます。
デフォルトでは、現在の作業用ディレクトリーは、現在のユーザーのホームディレクトリーであることに注意してください。
1.3.3. プルリクエストの送信
Git Perspective を使用してプルリクエスト (PR) を送信する方法を説明します。
特に共有リポジトリーで作業を行う場合、変更をマージする前に、ローカルリポジトリーを更新することが強く推奨されます。
手順
- CodeReady Studio を起動します。
- Git Perspective を開きます。
→ と右クリックします。
Pull Results ウインドウが表示されます。
- をクリックします。
これで、リモートリポジトリーからの変更がローカルリポジトリーにマージされます。
1.4. 変更のコミットおよびプッシュ
CodeReady Studio で変更をコミットおよびプッシュする方法を説明します。
手順
- CodeReady Studio を起動します。
- Git Perspective を開きます。
→ と右クリックします。
Git Staging ビューが表示されます。
- ステージする変更を選択します。
- Add selected files to the index アイコンをクリックし、変更をステージします。
Commit Message フィールドにコミットメッセージを追加します。
Author および Committer フィールドが自動的に入力されます。
- をクリックして変更をコミットするか、 をクリックして変更をコミットし、リモートリポジトリーにプッシュします。
Commit and Push オプションを選択すると、リポジトリーアドレスと、リポジトリーのアクセスユーザー名およびパスワードの入力を要求されることに注意してください。
第2章 CodeReady Studio における Maven の基本
Maven はアプリケーション開発の標準化されたビルドシステムを提供し、1 つ以上のリポジトリーから依存関係のフェッチを容易にします。
ルート Maven プロジェクトは、複数の Maven モジュール (サブプロジェクト) のアグリゲーターとして提供できます。Maven プロジェクトの一部である各モジュールには、<module> エントリーがプロジェクトの pom.xml ファイルに追加されます。pom.xml には <module> エントリーが含まれ、aggregator pom とも呼ばれます。
モジュールがプロジェクトに含まれる場合は、親プロジェクトディレクトリーから実行された 1 つコマンドにて、すべてのモジュールで Maven ゴールを実行できます。
2.1. 新規 Maven プロジェクトの作成
CodeReady Studio で新しい Maven プロジェクトを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
Ctrl+N キーを押します。
Select a wizard ウインドウが表示されます。
- Wizards フィールドに Maven と入力します。
- Maven Project を選択します。
をクリックします。
New Maven Project ウインドウが表示されます。
Create a simple project チェックボックスを選択します。
注記Create a simple project チェックボックスを選択すると、archetype の選択が省略されます。また、プロジェクトタイプは、マルチモジュールの Maven プロジェクトに必要な POM (Project Object Model) に自動的に設定されます。
代わりにスタンドアロンの Maven プロジェクトを作成するには、Create a simple project チェックボックスを未選択にし、画面上の指示に従ってパッケージオプションを
jarまたはwarに設定します。- をクリックしてワークスペースの場所を選択します。
をクリックします。
グループ ID とアーティファクト ID を入力します。
注記ID の値には、スペースや特殊文字を使用できません。使用できる特別文字は、ピリオド (
.)、アンダースコア (_)、およびダッシュ (-) のみです。一般的なグループ ID またはアーティファクト ID の例はorg.company-name_project-nameです。必要に応じて、プロジェクトに名前を付け、説明を追加できます。
- Packaging を pom、jar、または war に設定します。
- をクリックします。
新たに作成された Maven プロジェクトが CodeReady Studio ビューに表示されます。
2.2. 既存の Maven プロジェクトのインポート
既存の Maven プロジェクトを CodeReady Studio にインポートする方法を説明します。
2.2.1. ローカルに保存された既存の Maven プロジェクトのインポート
ローカルに保存された既存の Maven プロジェクトを CodeReady Studio にインポートする方法を説明します。
手順
- CodeReady Studio を起動します。
→ とクリックします。
Import ウインドウが表示されます。
- Select an import wizard フィールドに Maven と入力します。
- Existing Maven Projects を選択します。
をクリックします。
Import Maven Project ウインドウが表示されます。
- をクリックして、Maven プロジェクトを見つけます。
- をクリックします。
ローカルの Maven プロジェクトが CodeReady Studio ビューに表示されます。
2.2.2. リモートで保存された 既存の Maven プロジェクトのインポート
リモートで保存された既存の Maven プロジェクトを CodeReady Studio にインポートする方法を説明します。
手順
- CodeReady Studio を起動します。
- Git Perspective を開きます。
Clone a Git repository and import existing Maven projects アイコンをクリックします。
Check out as Maven project from SCM ウィンドウが表示されます。
- ソースリポジトリーのアドレスを SCM URL フィールドに追加します。
をクリックします。
Select Project Location ウインドウが表示されます。
- をクリックしてワークスペースの場所を選択します。
- をクリックします。
リモート Maven プロジェクトが Git Perspective ビューに追加されます。
2.3. 新しい Maven モジュールの作成
新しい Maven モジュールの作成方法を説明します。
前提条件
既存の Maven プロジェクト。
Maven プロジェクトの作成方法に関する詳細は、「新規 Maven プロジェクトの作成」 を参照してください。
手順
- CodeReady Studio を起動します。
Ctrl+N キーを押します。
Select a wizard ウインドウが表示されます。
- Wizards フィールドに Maven と入力します。
- Maven Module を選択します。
をクリックします。
New Maven Module ウインドウが表示されます。
Create a simple project チェックボックスを選択します。
注記Create a simple project チェックボックスを選択すると、archetype の選択が省略されます。また、プロジェクトタイプは、マルチモジュールの Maven プロジェクトに必要な POM (Project Object Model) に自動的に設定されます。
代わりにスタンドアロンの Maven プロジェクトを作成するには、Create a simple project チェックボックスを未選択にし、画面上の指示に従ってパッケージオプションを
jarまたはwarに設定します。- モジュールに名前を付けます。
- をクリックして、親プロジェクトを選択します。
をクリックします。
Configure Project ウインドウが表示されます。
Packaging を pom、jar、または war に設定します。
必要に応じて、モジュールに名前を付け、説明を追加できます。
- をクリックします。
新たに作成された Maven モジュールが CodeReady Studio ビューに表示されます。
2.4. Maven 依存関係の Maven プロジェクトへの追加
CodeReady Studio で Maven プロジェクトに Maven 依存関係を追加する方法を説明します。
前提条件
既存の Maven プロジェクト。
Maven プロジェクトの作成方法に関する詳細は、「新規 Maven プロジェクトの作成」 を参照してください。
手順
- CodeReady Studio を起動します。
- Project Explorer を開きます。
Maven の → → を右クリックします。
Add Dependency ウインドウが表示されます。
Enter groupId, artifactId or sha1 prefix or pattern フィールドに、グループ ID またはアーティファクト ID を入力します。
上記のフィールドは自動的に入力されます。
- をクリックします。
依存関係がプロジェクトの pom.xml ファイルに追加されます。
2.5. Maven サポートを Maven 以外の既存プロジェクトへ追加
Maven サポートを使用せずに作成されたアプリケーションに Maven サポートを追加する方法を説明します。
- CodeReady Studio を起動します。
- Project Explorer を開きます。
→ → を右クリックします。
Create a new POM ウインドウが表示されます。
すべてのフィールドは自動的に入力されます。グループ ID またはアーティファクト ID を変更する場合は、値にスペースまたは特殊文字を使用できません。使用できる特別文字は、ピリオド (
.)、アンダースコア (_)、およびダッシュ (-) のみです。一般的なグループ ID またはアーティファクト ID の例は org.company-name_project-name です。をクリックします。
新たに生成された
pom.xmlファイルが CodeReady Studio ビューに表示されます。
2.6. 関連情報
- Maven の使用方法については、JBoss Community Archive を参照してください。
第3章 CodeReady Studio でのアプリケーションデプロイメント
CodeReady Studio 内からサーバーにアプリケーションをデプロイするには、サーバーに関する情報で IDE を設定する必要があります。ローカルサーバーの場合、この情報には以下が含まれます。
- サーバーランタイム環境 (サーバーの場所、ランタイム JRE、設定ファイルの詳細など)
- サーバーアダプターとサーバーランタイム環境の管理設定 (アクセスパラメーター、起動引数、パブリッシュオプションなど)
JBoss Server Tools を使用すると、Runtime Detection (ランタイム検出) を使用して、ローカルサーバーを効率的に設定し、 CodeReady Studio と使用できるようにすることができます。この機能は、アプリケーションのデプロイとテストを行うサーバーを迅速に設定するのに役立ちます。
3.1. ローカルサーバーの設定
Runtime Detection (ランタイム検出) は、指定のローカルシステムパスを検索し、特定タイプのランタイムサーバーを見つけます。Runtime Detection は、見つかったサーバーに対してデフォルトのサーバーランタイム環境とデフォルトのサーバーアダプターの両方を自動的に生成します。これらは、アプリケーションを即座にデプロイするためにそのまま使用したり、要件に合わせてカスタマイズしたりできます。
CodeReady Studio でローカルサーバーを設定する方法を説明します。
手順
- CodeReady Studio を起動します。
→ をクリックします。
Preferences ウィンドウが表示されます。
- 検索フィールドに JBoss と入力します。
- JBoss Runtime Detection を選択します。
- をクリックします。
- ランタイムサーバーが含まれるディレクトリーを見つけます。
をクリックします。
Searching for runtimes ウィンドウが表示されます。
- をクリックします。
ランタイムサーバーのディレクトリーへのパスを選択します。
- をクリックします。
3.2. リモートサーバーの設定
CodeReady Studio でリモートサーバーを設定する方法を説明します。
手順
- CodeReady Studio を起動します。
Ctrl+N キーを押します。
Select a wizard ウインドウが表示されます。
- 検索フィールドに Server と入力します。
- Server を選択します。
をクリックします。
Define a New Server ウィンドウが表示されます。
- サーバータイプを選択します。
をクリックします。
Create a new Server Adapter ウィンドウが表示されます。
- Remote チェックボックスを選択します。
- Controlled by オプションを選択します。
- Server lifecycle external managed チェックボックスを選択します。
- Assign a runtime to server チェックボックスを選択します。
をクリックします。
JBoss Runtime ウィンドウが表示されます。
- Home Directory フィールドの をクリックして、ランタイムサーバーを見つけます。
をクリックします。
Remote System Integration ウィンドウが表示されます。
Remote Server Home フィールドで をクリックします。
Browse remote system ウインドウが表示されます。
- リモートサーバーが含まれるディレクトリーへのパスを指定します。
- をクリックします。
3.3. アプリケーションのデプロイ
ローカルサーバーの設定後に、サーバーアダプターを使用して CodeReady Studio からサーバーにアプリケーションをデプロイできます。サーバーアダプターは、アプリケーションとサーバー管理を簡単にデプロイできるように、サーバーと CodeReady Studio 間のランタイムの通信を可能にします。
CodeReady Studio のサーバーにアプリケーションをデプロイする方法を説明します。
手順
- CodeReady Studio を起動します。
→ → を右クリックします。
Run on Server ウインドウが表示されます。
- Choose an existing server チェックボックスを選択します。
- デプロイするサーバーを選択します。
- をクリックします。
内部の CodeReady Studio Web ブラウザーでアプリケーションが開かれます。
第4章 CodeReady Studio の JBoss EAP および JBoss WFK の基本
Eclipse IDE は、Red Hat JBoss Enterprise Application Platform (JBoss EAP) および Red Hat JBoss Web Framework Kit (JBoss WFK) でのアプリケーション開発およびデプロイメントをサポートします。
ただし、最初に Maven リポジトリーを設定する必要があります。この設定は、Red Hat Central で提供される、エンタープライズバージョンの Maven プロジェクトサンプルの使用に不可欠です。これらのプロジェクトは JBoss EAP へのデプロイメントを目的としており、JBoss EAP リポジトリーおよび JBoss WFK リポジトリーへの IDE のアクセスが必要になります。
4.1. Maven リポジトリーの設定
Maven リポジトリーを設定する方法を説明します。
手順
- CodeReady Studio を起動します。
→ をクリックします。
Preferences ウィンドウが表示されます。
- 検索フィールドに JBoss と入力します。
- JBoss Maven Integration を選択します。
をクリックします。
Configure Maven Repositories ウインドウが表示されます。
をクリックします。
Add Maven Repository ウインドウが表示されます。
- Profile ID フィールドの下向き矢印をクリックします。
redhat-ga-repository を選択します。
他のフィールドは自動的に入力されます。
- をクリックします。
をクリックします。
Confirm File Update ウインドウが表示されます。
- をクリックします。
- をクリックします。
関連情報
- Maven リポジトリーの詳細は、「Maven: Getting Started - Developers」を参照してください。
4.2. JBoss EAP の設定
Eclipse で JBoss EAP を設定するには、IDE がローカルまたはリモートのランタイムサーバーを示すようにする必要があります。これにより、IDE と JBoss EAP サーバー間の通信チャネルが確立され、デプロイメントおよびサーバー管理のワークフローが効率的になります。
CodeReady Studio で JBoss EAP をインストールする方法を説明します。
前提条件
設定済みの Maven リポジトリー。
Maven リポジトリーの設定方法に関する詳細は、「Maven リポジトリーの設定」 を参照してください。
手順
- CodeReady Studio を起動します。
→ をクリックします。
Preferences ウィンドウが表示されます。
- 検索フィールドに JBoss と入力します。
- JBoss Runtime Detection を選択します。
をクリックします。
Download Runtimes ウィンドウが表示されます。
必要な JBoss EAP バージョンを選択します。
注記JBoss EAP バージョン 6.0.x 以前を選択した場合は、画面の指示に従います。6.0.x よりも新しいバージョンを選択した場合は、以下の手順に従います。
をクリックします。
Credentials ウインドウが表示されます。
- をクリックします。
- access.redhat.com のユーザー名とパスワードを入力します。
- をクリックします。
をクリックします。
ライセンス契約の内容を確認します。ライセンス契約に同意し、 をクリックしてインストールを続行します。
Download Runtimes ウィンドウが表示されます。
- をクリックして、Install folder を選択します。
- をクリックして、Download folder を選択します。
をクリックします。
Runtime のダウンロードとインストールには時間がかかる場合があるため注意してください。
JBoss Runtime Detection ウインドウが表示されます。
- JBoss EAP インストールファイルへのパスを選択します。
- をクリックします。
検証手順
→ → とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Servers と入力します。
- Servers を選択します。
をクリックします。
Servers ビューが表示されます。
新たに追加された JBoss EAP が Servers ビューに表示されます。
第5章 CodeReady Studio での OpenShift の基本
CodeReady Studio には OpenShift Application Explorer ビューが含まれています。これにより、ユーザーエクスペリエンスが簡素化され、内部ループで簡単および迅速にフィードバックすることができ、デバックも容易および迅速に行うことができます。
OpenShift Application Explorer は、CodeReady Studio でデフォルトのビューとして設定されています。手動で開く必要がある場合は、「OpenShift Application Explorer ビューの設定」を参照してください。
5.1. OpenShift Application Explorer ビューの設定
CodeReady Studio で OpenShift Application Explorer を開く方法を説明します。
手順
- CodeReady Studio を起動します。
→ → とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Application Explorer を選択します。
をクリックします。
OpenShift Application Explorer ビューが表示されます。
5.2. OpenShift Application Explorer を使用した OpenShift クラスターへの接続
OpenShift Application Explorer を使用して CodeReady Studio で OpenShift クラスターにログインする方法を説明します。
手順
- CodeReady Studio を起動します。
- OpenShift Application Explorer を開きます。
Can't connect to cluster. Click to loging. をクリックします。
Login ウインドウが表示されます。
- ユーザー名とパスワードまたはトークンを入力します。
- ボタンをクリックします。
プロジェクトが OpenShift Application Explorer ビューに表示されます。
5.3. devfile に基づくアプリケーションのビルド
devfile を基にしてアプリケーションをデプロイするには、ローカルのワークスペースに空のプロジェクトが必要です。さらに、OpenShift にも devfile コンポーネントを作成するための空のプロジェクトが必要です。コンポーネントの確立後、プロジェクトが更新され、OpenShift で作成されたローカルおよびリモートアーティファクトも更新されます。
5.3.1. 空のプロジェクトの作成
CodeReady Studio で空のプロジェクトを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
Ctrl+N キーを押します。
Select a wizard ウインドウが表示されます。
- → を選択します。
をクリックします。
New Project ウインドウが表示されます。
- プロジェクトに名前を付けます。
- プロジェクトの場所を選択します。
- をクリックします。
新たに作成した空のプロジェクトが Project Explorer ビューに表示されます。
5.3.2. OpenShift Application Explorer を使用した空の OpenShift プロジェクトの作成
CodeReady Studio で OpenShift Application Explorer を使用して空のプロジェクトを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
- OpenShift Application Explorer を起動します。
→ → の任意の場所をクリックします。
New project ウインドウが表示されます。
- プロジェクトに名前を付けます。
- をクリックします。
新たに作成したプロジェクトが OpenShift Application Explorer ビューに表示されます。
5.3.3. OpenShift Application Explorer を使用した devfile コンポーネントの作成
CodeReady Studio で OpenShift Application Explorer を使用して devfile コンポーネントを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
- OpenShift Application Explorer を起動します。
ターゲットの → → を右クリックします。
Create component ウィンドウが表示されます。
- プロジェクトに名前を付けます。
- をクリックして Eclipse Project を選択します。
-
Component type を
java-vertxに設定します。 -
Project starter を
java-vertxに設定します。 - アプリケーションに名前を付けます。
- Push after create チェックボックスを未選択にします。
- をクリックします。
Console ビューが表示され、検証プロセスが表示されます。
新たに作成されたコンポーネントが、プロジェクト下の OpenShift Application Explorer ビューに表示されます。
5.4. S2I ファイルを基にしたアプリケーションのビルド
S2I ファイルを基にしてアプリケーションをデプロイするには、ローカルのワークスペースに空のプロジェクトが必要です。さらに、OpenShift にもコンポーネントを作成するための空のプロジェクトが必要です。コンポーネントの確立後、プロジェクトが更新され、OpenShift で作成されたローカルおよびリモートアーティファクトも更新されます。
5.4.1. ランチャープロジェクトの作成
CodeReady Studio でランチャープロジェクトを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
Ctrl+N キーを押します。
Select a wizard ウインドウが表示されます。
- 検索フィールドに Launcher と入力します。
- Launcher project を選択します。
をクリックします。
New Launcher project ウインドウが表示されます。
-
Mission を
rest-httpに設定します。 -
Runtime を
vert.x communityに設定します。 - プロジェクトに名前を付けます。
- プロジェクトの場所を選択します。
をクリックします。
依存関係の解決プロセスが完了するまで時間がかかることがあるため注意してください。
新た作成されたランチャープロジェクトが Project Explorer ビューに表示されます。
5.4.2. OpenShift Application Explorer での空の OpenShift プロジェクトの作成
CodeReady Studio で OpenShift Application Explorer を使用して空のプロジェクトを作成する方法を説明します。
手順
→ → の任意の場所をクリックします。
New project ウインドウが表示されます。
- プロジェクトに名前を付けます。
- をクリックします。
新たに作成したプロジェクトが OpenShift Application Explorer ビューに表示されます。
5.4.3. OpenShift Application Explorer を使用した S2I コンポーネントの作成
CodeReady Studio で OpenShift Application Explorer を使用してコンポーネントを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
- OpenShift Application Explorer を起動します。
ターゲットの → → を右クリックします。
Create component ウィンドウが表示されます。
- プロジェクトに名前を付けます。
- をクリックして Eclipse Project を選択します。
-
S2Iの横にある矢印をクリックし、Component type をjavaに設定します。 -
Component version を
latestに設定します。 - アプリケーションに名前を付けます。
- Push after create チェックボックスを未選択にします。
- をクリックします。
Console ビューが表示され、検証プロセスが表示されます。
新たに作成されたコンポーネントが、プロジェクト下の OpenShift Application Explorer ビューに表示されます。
5.5. OpenShift Application Explorer を使用したクラスターへのコンポーネントのデプロイ
CodeReady Studio で OpenShift Application Explorer を使用して、クラスターにコンポーネントをデプロイする方法を説明します。
手順
- CodeReady Studio を起動します。
- OpenShift Application Explorer を起動します。
- プロジェクトを展開します。
- アプリケーションを展開します。
→ を右クリックします。
Console ビューが表示され、ファイル同期化のプロセスが表示されます。
5.6. OpenShift Application Explorer を使用した外部アクセス URL の定義
CodeReady Studio で OpenShift Application Explorer を使用して外部アクセス URL を定義する方法を説明します。
手順
- CodeReady Studio を起動します。
- OpenShift Application Explorer を起動します。
- プロジェクトを展開します。
- アプリケーションを展開します。
→ → を右クリックします。
Create URL ウインドウが表示されます。
- URL に名前を付けます。
- Port の値を 8080 に設定します。
をクリックします。
Console ビューが表示され、URL 作成のプロセスが表示されます。
OpenShift Application Explorer で、 → を右クリックします。
Console ビューが表示され、ファイル同期化のプロセスが表示されます。
新たに作成された URL がコンポーネント下の OpenShift Application Explorer ビューに表示されます。
5.7. OpenShift Application Explorer を使用したクラスターでのアプリケーションのデバッグ
CodeReady Studio で OpenShift Application Explorer を使用して、クラスターでアプリケーションをデバッグする方法を説明します。
手順
- CodeReady Studio を起動します。
-
Project Explorer ビューで
MainVerticle.java(devfiles) またはHttpApplication.java(S2I) ファイルを見つけ、ダブルクリックして開きます。 左側がルーラーになっている列をクリックし、ブレークポイントを設定します。
- OpenShift Application Explorer を開きます。
- プロジェクトを展開します。
- アプリケーションを展開します。
→ を右クリックします。
Console ビューが表示されます。
- OpenShift Application Explorer で、コンポーネントを展開します。
→ を右クリックします。
Confirm Perspective Switch ウインドウが表示されます。
をクリックします。
Debug Perspective ウィンドウが表示され、デバッグプロセスが表示されます。
第6章 CodeReady Studio の Quarkus ツールの基本
Quarkus は Kubernetes ネイティブのフルスタック Java フレームワークで、Java 仮想マシンとの作業を最適化することを目的としています。Quarkus は、Quarkus アプリケーション開発者向けのツールを提供します。
前提条件
- 最新バージョンの JBoss Tools がインストールされている。詳細は、「JBoss Tools Downloads」を参照してください。
6.1. 新しい Quarkus プロジェクトの作成
CodeReady Studio で新しい Quarkus プロジェクトを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
Ctrl+N キーを押します。
Select a wizard ウインドウが表示されます。
- 検索フィールドに Quarkus と入力します。
- Quarkus Project を選択します。
をクリックします。
New Quarkus project ウインドウが表示されます。
- 必要なプロジェクトタイプを選択します。
- プロジェクトに名前を付けます。
- プロジェクトの場所を選択します。
をクリックします。
Project type ウインドウが表示されます。
- デフォルト値が正しいことを確認します。
をクリックします。
Quarkus extensions ウインドウが表示されます。
プロジェクトに必要な Categories を選択します。
選択したカテゴリーに使用可能なエクステンションが Extensions 列に表示されます。
プロジェクトに必要な Extensions を選択します。
エクステンションをダブルクリックして選択または選択解除します。選択したエクステンションが Selected 列に表示されます。
- をクリックします。
新たに作成された Quarkus プロジェクトが Project Explorer ビューに表示されます。
6.2. Quarkus アプリケーションの実行
CodeReady Studio で Quarkus アプリケーションを実行する方法を説明します。
手順
- CodeReady Studio を起動します。
→ とクリックします。
Run Configurations ウィンドウが表示されます。
Quarkus Application まで下へスクロールします。
→ を右クリックします。
- 設定に名前を付けます。
- をクリックしてプロジェクトを見つけます。
- をクリックします。
クリックします。
Console ビューが表示されます。
アプリケーションは、ビルドプロセスの後に起動します。
6.3. Quarkus アプリケーションのデバッグ
CodeReady Studio で Quarkus アプリケーションをデバッグする方法を説明します。
手順
- CodeReady Studio を起動します。
→ とクリックします。
Debug Configurations ウィンドウが表示されます。
- Quarkus Application を展開します。
- 設定を選択します。
をクリックします。
Console ビューが表示されます。
Quarkus アプリケーションが起動し、リモート JVM デバッグ設定に接続します。アプリケーションのソースファイルにブレークポイントを設定すると、ブレークポイントに到達した後に実行が自動的に停止します。
6.4. CodeReady Studio での言語サポートの使用
すべての Quarkus アプリケーションは、application.properties 設定ファイルを使用して設定されます。この設定ファイルの内容は、アプリケーションが使用している Quarkus エクステンションのセットによって異なります。
Quarkus ツールには、コード補完、検証、およびドキュメントを提供するコンテンツアシストが含まれています。コード補完により、コードのステートメントを迅速に完了できます。ポップアップから複数の選択肢を利用することができます。この言語サポートは、Kubernetes、OpenShift、S2i、Docker プロパティー、MicroProfile REST Client プロパティー、および MicroProfile Health アーティファクトで使用できるようになりました。
6.4.1. Quarkus のコンテンツアシストの使用
CodeReady Studio で Quarkus の application.properties コンテントアシストを使用する方法を説明します。
前提条件
既存の Quarkus プロジェクト。
Quarkus プロジェクトの作成方法に関する詳細は、「新しい Quarkus プロジェクトの作成」 を参照してください。
手順
- CodeReady Studio を起動します。
- Project Explorer を起動します。
- → を展開します。
→ → を右クリックします。
Generic Text Editor ウインドウが表示されます。
- 空の行に移動します。
Ctr+Space キーを押して、コード補完を実行します。
コード補完のサジェスチョンが表示されます。マウスカーソルをサジェスチョンの上に移動し、ドキュメントを表示します。
エディターで誤った値を入力すると、エラーの下に赤い波線が表示されます。
関連情報
- MicroProfile REST Client プロパティーの言語サポートは、個別に有効にする必要があります。詳細は、「MicroProfile REST Client プロパティーの言語サポートの有効化」 を参照してください。
6.4.2. MicroProfile REST Client プロパティーの言語サポートの有効化
MicroProfile REST Client プロパティーの言語サポートを有効にする方法を説明します。
前提条件
既存の Quarkus プロジェクト。
Quarkus プロジェクトの作成方法に関する詳細は、「新しい Quarkus プロジェクトの作成」 を参照してください。
手順
- CodeReady Studio を起動します。
- Project Explorer を起動します。
- → を展開します。
→ → を右クリックします。
Select wizard ウインドウが表示されます。
- 検索フィールドに file と入力します。
- File を選択します。
をクリックします。
Create a new file resource ウインドウが表示されます。
- 新しいファイルに名前を付けます。
- をクリックします。
新たに作成されたファイルに以下の内容を貼り付けます。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Ctrl+S キーを押して変更を保存します。
クライアントの設定キーを @RegisterRestClient から に変更すると、言語サポートを調整できます。言語サポートは状況に応じて調整されます。
@RegisterRestClient (configKey = "myclient")
その他のリソース
- 言語サポートの使用方法の詳細は、「Quarkus のコンテンツアシストの使用」 を参照してください。
第7章 CodeReady Studio の Hibernate Tools の基本
Hibernate Tools は、Hibernate バージョン 5 以前に関連するプロジェクトのツールのコレクションです。このツールは、Hibernate とのリバースエンジニアリング、コード生成、可視化、および対話を行う Eclipse プラグインを提供します。
7.1. 新規 JPA プロジェクトの作成
CodeReady Studio で新規 JPA プロジェクトを作成する方法を説明します。
前提条件
CodeReady Studio で新しい JPA プロジェクトを作成する前に、Sakila データベースサーバーを起動する必要があります。
- h2 バージョンの Sakila データベース をダウンロードします。
-
runh2.shファイルが含まれるディレクトリーに移動します。 runh2.shファイルを実行します。./runh2.sh
$ ./runh2.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow
手順
- CodeReady Studio を起動します。
Ctrl+N キーを押します。
Select a Wizard ウインドウが表示されます。
- 検索フィールドに JPA と入力します。
- JPA Project を選択します。
をクリックします。
New JPA Project ウインドウが表示されます。
- プロジェクトに名前を付けます。
- プロジェクトの場所を選択します。
- Target runtime フィールドで下矢印をクリックし、ランタイムサーバーを選択します。
- JPA version を 2.1 に設定します。
をクリックします。
Java ウィンドウが表示されます。
- ソースフォルダーを選択します。
をクリックします。
JPA Facet ウィンドウが表示されます。
- Platform フィールドの下矢印をクリックし、Hibernate (JPA 2.1) を選択します。
ユーザーライブラリーを追加するか、JPA Implementation Type を Disable Library Configuration に設定します。
ユーザーライブラリーの設定方法の詳細は、「ライブラリーの追加」 を参照してください。
をクリックします。
Connection Profile ウインドウが表示されます。
- 検索フィールドに Generic と入力します。
- Generic JDBC を選択します。
- Name フィールドに Sakila と入力します。
をクリックします。
Specify a Driver and Connection Details ウィンドウが表示されます。
アイコンをクリックします。
New Driver Definition ウインドウが表示されます。
- Generic JDBC Driver を選択します。
JAR List タブをクリックします。
- ボタンをクリックします。
-
Sakila データベースの
.jarファイルを選択します。 Properties タブをクリックします。
-
jdbc:h2:tcp://localhost/./sakilaを Connection URL フィールドに追加します。 - Driver Class フィールドをクリックします。
Driver Class フィールドの末尾にある、点 3 つのアイコンをクリックします。
Available Classes from Jar List ウインドウが表示されます。
- Browse for Class オプションを選択します。
- org.h2.Driver を選択します。
- をクリックします。
User ID フィールドに
saと入力します。- → → とクリックします。
新たに作成された JPA プロジェクトが Project Explorer に表示されます。
7.2. ライブラリーの追加
CodeReady Studio で、Hibernate プロジェクトにライブラリーを追加する方法を説明します。
手順
- Hibernate ORM をダウンロードします。
- ファイルを展開します。
- CodeReady Studio を起動します。
→ をクリックします。
Preferences ウィンドウが表示されます。
- 検索フィールドに Libraries と入力します。
- Java で User Libraries を選択します。
ボタンをクリックします。
New User Library ウィンドウが表示されます。
- ユーザーライブラリーに名前を付けます。
- をクリックします。
新しいユーザーライブラリーを選択します。
- ボタンをクリックします。
- Hibernate ORM ファイルを展開したディレクトリーを選択します。
-
/lib/required/ディレクトリーに移動します。 -
.jarファイルを選択します。 をクリックします。
選択した
.jarファイルがユーザーライブラリーに表示されます。- をクリックします。
7.3. エンティティーからのテーブルの生成
CodeReady Studio で Hibernate プロジェクトのエンティティーからテーブルを生成する方法を説明します。
手順
- CodeReady Studio を起動します。
- Project Explorer を開きます。
→ → を右クリックします。
Generate Table from Entities ウィンドウが表示されます。
- Use Console Configuration チェックボックスを選択します。
- をクリックします。
7.4. Hibernate マッピングファイルの作成
Hibernate マッピングファイルは、オブジェクトがどのようにデータベーステーブルに関連するかを指定します。
CodeReady Studio で Hibernate マッピングファイルを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
Ctr+N キーを押します。
Select a wizard ウインドウが表示されます。
- 検索フィールドに Hibernate と入力します。
- Hibernate XML Mapping file (hbm.xml) を選択します。
をクリックします。
Create Hibernate XML Mapping file ウインドウが表示されます。
- ボタンをクリックしてクラスを追加します。
ボタンをクリックしてパッケージを追加します。
または、パッケージまたはクラスを選択せずに空の
.hbm.xmlファイルを作成することもできます。- depth control チェックボックスを選択し、クラスの選択時に使用される依存関係の深さを定義します。
をクリックします。
New Hibernate XML Mapping files ウインドウが表示されます。
- 親ディレクトリーを選択します。
-
.hbm.xmlファイルに名前を付けます。 - をクリックします。
7.5. Hibernate 設定ファイルの作成
リバースエンジニアリング、プロトタイプクエリー、または Hibernate Core の使用には、hibernate.properties または hibernate.cfg.xml ファイルが必要になります。CodeReady Studio には、設定ファイル hibernate.cfg.xml を生成するウィザードがあります。
CodeReady Studio で Hibernate 設定ファイルを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
Ctr+N キーを押します。
Select a wizard ウインドウが表示されます。
- 検索フィールドに Hibernate と入力します。
- Hibernate Configuration file (cfg.xml) を選択します。
をクリックします。
Create Hibernate Configuration file (cfg.xml) ウインドウが表示されます。
- 親ディレクトリーを選択します。
をクリックします。
Hibernate Configuration File(cfg.xml) ウインドウが表示されます。
- Database dialect フィールドの下矢印をクリックして、データベースを選択します。
- Driver class フィールドの下矢印をクリックして、ドライバーを選択します。
- Connection URL フィールドの下矢印をクリックし、URL を選択します。
- をクリックします。
7.6. Hibernate コンソール設定ファイルの作成
コンソール設定ファイルには、Hibernate プラグインがどのように Hibernate を設定するかが記述されています。また、POJO や JDBC ドライバーなどのロードに必要な設定ファイルおよびクラスパスも記述されています。これは、クエリープロトタイピング、リバースエンジニアリング、およびコードの生成を使用するために必要です。プロジェクトごとに複数のコンソール設定を指定できますが、1 つの設定で十分です。
CodeReady Studio で Hibernate コンソール設定ファイルを作成する方法を説明します。
手順
- CodeReady Studio を起動します。
Ctr+N キーを押します。
Select a wizard ウインドウが表示されます。
- 検索フィールドに Hibernate と入力します。
- Hibernate Console Configuration を選択します。
をクリックします。
Create Hibernate Console Configuration ウィンドウが表示されます。
- 設定ファイルに名前を付けます。
- Type が Core に設定されていることを確認します。
- 正しい Hibernate version を選択します。
- をクリックしてプロジェクトを見つけます。
をクリックして、新しい Database connection を設定します。
New Connection Profile ウインドウが表示されます。
- Data Connection を選択するか、新たに作成します。
をクリックし、Property file を設定します。
Setup property file ウインドウを表示します。
をクリックします。
Create Hibernate Properties file (.properties) ウインドウが表示されます。
- 親ディレクトリーを選択します。
-
.propertiesファイルに名前を付けます。 - をクリックします。
- をクリックし、Configuration file を設定します。
ターゲット
.cfg.xmlファイルへのパスを選択します。Setup configuration file ウインドウが表示されます。
をクリックします。
Create Hibernate Configuration file (cfg.xml) ウインドウが表示されます。
- 親ディレクトリーを選択します。
をクリックします。
Hibernate Configuration File(cfg.xml) ウインドウが表示されます。
- Database dialect フィールドの下矢印をクリックして、データベースを選択します。
- Driver class フィールドの下矢印をクリックして、ドライバーを選択します。
- Connection URL フィールドの下矢印をクリックし、URL を選択します。
をクリックします。
- をクリックします。
7.7. Hibernate プロジェクト設定の編集
CodeReady Studio で Hibernate プロジェクトの設定を編集する方法を説明します。
手順
- CodeReady Studio を起動します。
→ → とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Hibernate と入力します。
- Hibernate Configurations を選択します。
をクリックします。
Hibernate Configurations ビューが表示されます。
→ を右クリックします。
Edit Configuration ウインドウが表示されます。
- 設定を編集します。
- をクリックします。
- をクリックします。
第8章 CodeReady Studio での Mobile Web Tools の基本
Mobile Web Tools は、モバイルデバイス向けに最適化された Web アプリケーションの作成を可能にする HTML5 Project ウィザードを提供します。HTML5 Project ウィザードは、CodeReady Studio ですべての新規 HTML5 Web アプリケーションを作成するための便利なウィザードです。このウィザードは、Maven archetype からの REST リソースを使用して、そのままデプロイできる HTML5 モバイルアプリケーションのサンプルを生成します。
+ 組み込みエディターを使用してアプリケーションをカスタマイズでき、組み込みブラウザーでアプリケーションをデプロイおよび表示できます。
CodeReady Studio では、ユーザーが対話式の Web アプリケーションを作成できる Mobile Web パレットが提供されます。このパレットは、HTML5、jQuery Mobile、および Ionic タグなどの一般的な Web インターフェースフレームワーク機能を html ファイルに追加するドラッグアンドドロップウィジェットなど、幅広い機能を提供します。また、よりユーザーフレンドリーで効率的なアプリケーションを実現するための、Panels、Pages、Lists、および Buttons などのウィジェットも含まれています。
8.1. HTML5 プロジェクトの作成
HTML5 Project ウィザードは、Maven アーキタイプと、提供するプロジェクトおよびアプリケーション識別子を基にして、サンプルプロジェクトを生成します。Maven archetype バージョンは、ウィザードの最初のページにある Description フィールドに示されます。バージョンを変更できるため、ウィザード内でエンタープライズまたは非エンタープライズいずれかのターゲットランタイムを選択して、プロジェクトの見た目と依存関係も変更できます。
CodeReady Studio で HTML5 プロジェクトを作成する方法を説明します。
前提条件
設定済みのサーバー。
ローカルランタイムサーバーの設定およびアプリケーションのローカルランタイムサーバーへのデプロイメントに関する詳細は、「ローカルサーバーの設定」 を参照してください。
CodeReady Studio は、アプリケーションをデプロイするすべてのサーバーに対して設定する必要があります。これには、アプリケーションサーバーの場所およびタイプ、カスタム設定、カスタム管理設定などが含まれます。
手順
- CodeReady Studio を起動します。
Ctr+N キーを押します。
Select a wizard ウインドウが表示されます。
- 検索フィールドに HTML5 と入力します。
- HTML5 Project を選択します。
をクリックします。
New Project Example ウィンドウが表示されます。
- Target Runtime フィールドの下矢印をクリックします。
- サーバーを選択します。
- をクリックします。
- プロジェクトとパッケージに名前を付けます。
- プロジェクトの場所を選択します。
をクリックします。
プロジェクトの生成には時間がかかる場合があります。
New Project Example ウィンドウが表示されます。
- をクリックします。
新たに作成されたプロジェクトが Project Explorer ビューに表示されます。
8.2. 新しい HTML5 jQuery Mobile ファイルの追加
HTML5 jQuery Mobile ファイルテンプレートは、ファイルの HTML ヘッダーに挿入される JavaScript および CSS ライブラリー参照で構成されます。このテンプレートは、jQuery Mobile ページのスケルトンや、ファイルの HTML ボディーの listview ウィジェットも挿入します。
既存のプロジェクトに新しい HTML5 jQuery Mobile ファイルを追加する方法を説明します。
前提条件
設定済みのサーバー。
ローカルランタイムサーバーの設定およびアプリケーションのローカルランタイムサーバーへのデプロイメントに関する詳細は、「ローカルサーバーの設定」 を参照してください。
CodeReady Studio は、アプリケーションをデプロイするすべてのサーバーに対して設定する必要があります。これには、アプリケーションサーバーの場所およびタイプ、カスタム設定、カスタム管理設定などが含まれます。
手順
- CodeReady Studio を起動します。
Ctr+N キーを押します。
Select a wizard ウインドウが表示されます。
- 検索フィールドに HTML と入力します。
- HTML File を選択します。
をクリックします。
New HTML File ウインドウが表示されます。
- ファイルの場所を選択します。
- ファイルに名前を付けます。
をクリックします。
Select HTML Template ウインドウが表示されます。
- テンプレートを選択します。
- をクリックします。
新たに作成された HTML ファイルが CodeReady Studio エディターに表示されます。
8.3. 新しいモバイルページの追加
既存の Web アプリケーションに新しい jQuery Mobile ページを追加する方法を説明します。
前提条件
HTML5 プロジェクト。
HTML5 プロジェクトの作成方法についての詳細は、「HTML5 プロジェクトの作成」 を参照してください。
手順
- CodeReady Studio を起動します。
→ → とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Palette と入力します。
- Palette を選択します。
をクリックします。
Palette ビューが表示されます。
Page アイコンをクリックします。
Insert Tag ウィンドウが表示されます。
- Header に名前を付けます。
- Footer に名前を付けます。
- をクリックします。
新たに追加されたページが CodeReady Studio エディターに表示されます。
Palette ビューからのウィジェットを選択して、Web アプリケーションのページをカスタマイズする場合、同じワークフローが使用されます。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}