コンテナーおよびクラウドベースの開発のスタートガイド
Red Hat CodeReady Studio を使用したコンテナーおよびクラウドベースのアプリケーション開発
Eva-Lotte Gebhardt
egebhard@redhat.com
Levi Valeeva
levi@redhat.com
Supriya Takkhi
sbharadw@redhat.com
Yana Hontyk
yhontyk@redhat.com
devtools-docs@redhat.com
概要
多様性を受け入れるオープンソースの強化
Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、今後の複数のリリースで段階的に用語の置き換えを実施して参ります。詳細は、弊社 の CTO、Chris Wright のメッセージ を参照してください。
第1章 CodeReady Studio でコンテナーおよびクラウドを使用した開発
1.1. CodeReady Studio での Red Hat CodeReady Containers ツールの使用
Red Hat CodeReady Containers (CRC) は、ローカルシステムに最小限の OpenShift 4 クラスターを提供します。このクラスターは、開発およびテストを目的とする最低限の環境を提供します。これは主に開発者のデスクトップでの実行を目的としています。ヘッドレス、複数開発者、またはチームベースのセットアップなどの他のユースケースでは、完全な OpenShift インストーラー を使用することが推奨されます。
OpenShift の詳細は、OpenShift のドキュメント を参照してください。
1.1.1. Red Hat CodeReady コンテナーのダウンロードおよびインストール
CodeReady Studio で CodeReady コンテナーを設定する方法を説明します。
前提条件
- 最新リリースの CodeReady Containers とプルシークレットをダウンロード しておく必要があります。
CRC ファイルの展開。
CRC のインストールおよび設定方法の詳細は、『Getting started with CodeReady Containers Guide』の「Installation」の章を参照してください。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Server と入力します。
- Servers を選択します。
Open をクリックします。
Servers ビューが表示されます。
Servers ビューの任意の場所をクリックします。
New → Server とクリックします。
Define a New Server ウィンドウが表示されます。
- CodeReady Containers 1.0+ を選択します。
Next をクリックします。
CodeReady Containers ウインドウが表示されます。
- Browse をクリックして CRC binary を見つけます。
- Browse をクリックして CRC Pull Secret File を見つけます。
- Finish をクリックします。
新たに追加された CodeReady Containers 1.0+ サーバーアダプターが Servers ビューに表示されます。
サーバーアダプターを起動する前に CRC を設定しなかった場合は、CRC has not been properly initialized! という警告が表示されます。
画面の指示に従って CRC を初期化します。
手順では、開発を支援するために、任意の匿名による使用状況データ収集を求めるプロンプトが表示されます。個人を特定できる情報は収集されません。後で設定を変更する方法については、「Red Hat CodeReady Containers - Consent for telemetry data collection」を参照してください。
1.1.2. OpenShift Container Platform ツールの使用
CodeReady Studio で OpenShift コンテナーを使用する方法を説明します。
前提条件
CRC サーバーアダプターが設定済みである。
詳細は、「CRC のダウンロードおよびインストール」を参照してください。
手順
- CodeReady Studio を起動します。
CRC サーバーアダプターを起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Explorer を選択します。
Open をクリックします。
OpenShift Explorer ビューが表示されます。
新しい OpenShift コネクションの設定方法については、「Creating a new OpenShift Container Platform connection」を参照してください。
Ctrl+N キーを押します。
Select a wizard ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Application を選択します。
Next をクリックします。
Sign in to OpenShift ウィンドウが表示されます。
クレデンシャルを入力し、Next をクリックします。
Create OpenShift Project ウインドウが表示されます。
- プロジェクトに名前を付けます。
Finish をクリックします。
Select template ウインドウが表示されます。
- テンプレートを選択します。
Next をクリックします。
Template Parameters ウインドウが表示されます。
- テンプレートパラメーターが正しいことを確認します。
Finish をクリックします。
Create Application Summary ウィンドウが表示されます。
- アプリケーションの詳細が正しいことを確認します。
OK をクリックします。
Import OpenShift Application ウインドウが表示されます。
- git リポジトリーをクローンする場所を選択します。
- Finish をクリックします。
新たに作成された OpenShift プロジェクトとアプリケーションが OpenShift Explorer ビューに表示されます。
その他のリソース
- OpenShift Container Platform プロジェクトおよびアプリケーションで追加のタスクを実行する方法の詳細は、「Developing for the Cloud with OpenShift in CodeReady Studio」を参照してください。
1.2. CodeReady Studio での Red Hat Container Development Kit ツールの使用
Red Hat Container Development Kit (CDK) は、Red Hat Enterprise Linux (RHEL) をベースとした事前にビルドされたコンテナー開発環境です。CDK は、コンテナーベースのアプリケーションをすぐに開発できるようにします。
1.2.1. Container Development Kit のインストール
CodeReady Studio 内から CDK をインストールする方法を説明します。
前提条件
ハイパーバイザーがシステムにインストールされ、設定されていることを確認します。
- VirtualBox、Linux KVM/libvirt (Linux)
- xhyve (macOS)
- Hyper-V (Windows)
システムでハードウェアの仮想化が有効になっていることを確認します。
詳細は『Setting Up the Virtualization Environment』を参照してください。
Red Hat Developer アカウントがあることを確認してください。
新規アカウントを作成するには、developers.redhat.com にアクセスします。
CDK の詳細は『Red Hat Container Development Kit Getting Started Guide』を参照してください。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Server と入力します。
- Servers を選択します。
Open をクリックします。
Servers ビューが表示されます。
Servers ビューの任意の場所をクリックします。
New → Server とクリックします。
Define a New Server ウィンドウが表示されます。
- Red Hat Container Development Kit 3.2+ を選択します。
Next をクリックします。
Red Hat Container Development Environment ウインドウが表示されます。
Download and install runtime をクリックします。
Download Runtimes ウィンドウが表示されます。
- Red Hat CDK バージョンを選択します。
- Next をクリックします。
- access.redhat.com のログインクレデンシャルが正しいことを確認します。
- Next をクリックします。
- ライセンス契約書を読み、承諾してから Next をクリックします。
インストールフォルダーを選択し、Finish をクリックします。
ランタイムのダウンロードおよびインストールが完了するまで時間がかかることがあるため注意してください。
Finish をクリックします。
新たに作成された Container Development Environment 3.2+ サーバーが Servers ビューに表示されます。
CDK server adapter → Start を右クリックします。
注記サーバーアダプターを起動する前に CDK を設定しなかった場合は、CDK has not been properly initialized! という警告が表示されます。
画面の指示に従って CDK を初期化します。
1.2.2. Docker ツールの使用
1.2.2.1. Dockerfile の作成
前提条件
CDK サーバーアダプターが設定済みである。
詳細は、「CDK のインストール」を参照してください。
手順
- CodeReady Studio を起動します。
CDK サーバーアダプターを起動します。
Ctrl+N キーを押します。
Select a wizard ウインドウが表示されます。
- 検索フィールドに Java Project と入力します。
- Java Project を選択します。
Next をクリックします。
New Java Project ウインドウが表示されます。
プロジェクトに名前を付けます。
New module-info.java ウィンドウが表示されます。
-
新しい
module-info.java
ファイルを作成するか、Don't Create をクリックします。 Finish をクリックします。
新たに作成された Java プロジェクトが Project Explorer ビューに表示されます。
Java project → New → File を右クリックします。
Create New File ウインドウが表示されます。
- 親フォルダーを選択します。
- ファイルに名前を付けます。
Finish をクリックします。
新たに作成されたファイルが CodeReady Studio エディターに表示されます。
新たに作成されたファイルに以下の内容を貼り付けます。
# Use latest jboss/base-jdk:8 image as the base FROM jboss/base-jdk:8 # Set the WILDFLY_VERSION env variable ENV WILDFLY_VERSION 10.1.0.Final ENV WILDFLY_SHA1 9ee3c0255e2e6007d502223916cefad2a1a5e333 ENV JBOSS_HOME /opt/jboss/wildfly USER root # Add the WildFly distribution to /opt, and make wildfly the owner of the extracted tar content # Make sure the distribution is available from a well-known place RUN cd $HOME \ && curl -O https://download.jboss.org/wildfly/$WILDFLY_VERSION/wildfly-$WILDFLY_VERSION.tar.gz \ && sha1sum wildfly-$WILDFLY_VERSION.tar.gz | grep $WILDFLY_SHA1 \ && tar xf wildfly-$WILDFLY_VERSION.tar.gz \ && mv $HOME/wildfly-$WILDFLY_VERSION $JBOSS_HOME \ && rm wildfly-$WILDFLY_VERSION.tar.gz \ && chown -R jboss:0 ${JBOSS_HOME} \ && chmod -R g+rw ${JBOSS_HOME} # Ensure signals are forwarded to the JVM process correctly for graceful shutdown ENV LAUNCH_JBOSS_IN_BACKGROUND true USER jboss # Expose the ports we're interested in EXPOSE 8080 # Set the default command to run on boot # This will boot WildFly in the standalone mode and bind to all interface CMD ["/opt/jboss/wildfly/bin/standalone.sh", "-b", "0.0.0.0"]
- Ctrl+S キーを押して変更を保存します。
Dockerfile が作成されます。
その他のリソース
- Dockerfile の詳細は、「Dockerfile reference」を参照してください。
1.2.2.2. Red Hat Container Development Kit を使用した Docker イメージのビルド
前提条件
CDK サーバーアダプターが設定済みである。
詳細は、「CDK のインストール」を参照してください。
Java プロジェクトおよび Dockerfile。
詳細は、「Dockerfile の作成」を参照してください。
手順
- CodeReady Studio を起動します。
CDK サーバーアダプターを起動します。
Java プロジェクトを展開します。
Dockerfile → Run as → Docker Image Build を右クリックします。
Docker Image Build Configuration ウインドウが表示されます。
- コネクションとして Container Development Environment サーバーアダプターを選択します。
- イメージに名前を付けます。
- OK をクリックします。
Console ビューが表示され、docker イメージのビルドプロセスが表示されます。
1.2.3. その他のリソース
- OpenShift Container Platform ツールでタスクを実行する方法の詳細は、「Developing for the Cloud with OpenShift in CodeReady Studio」を参照してください。
- CodeReady Studio で OpenShift を使用する方法の詳細は、「OpenShift basics in CodeReady Studio」を参照してください。
第2章 CodeReady Studio で OpenShift を使用したクラウド向けの開発
2.1. CodeReady Studio での OpenShift Container Platform アプリケーションの作成
OpenShift Container Platform ツールを使用すると、OpenShift Container Platform アプリケーションを作成、インポート、および変更できます。
2.1.1. 新規 OpenShift Container Platform コネクションの作成
CodeReady Studio で OpenShift ツールを使用するには、OpenShift Explorer ビューで OpenShift コネクションを作成する必要があります。OpenShift コネクションは、CodeReady Studio を OpenShift インスタンス (CDK、OpenShift Online、Kubernetes、minishift をベースとした) に接続します。コネクションは OpenShift Explorer ビューに表示されます。CodeReady Studio に複数の OpenShift コネクションを設定できます。
前提条件
- CodeReady Containers サーバーアダプターが実行中である。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Explorer を選択します。
Open をクリックします。
OpenShift Explorer ビューが表示されます。
- OpenShift Explorer の任意の場所を右クリックします。
New → Connection とクリックします。
Sign in to OpenShift ウィンドウが表示されます。
- Server フィールドに OpenShift サーバーの URL を貼り付けます。
トークンまたはログインクレデンシャルを使用して認証します。
注記または、ログインコマンドを OpenShift Container Platform Web UI からコピーすることもできます。
ログインクレデンシャルを取得するには、drop-down menu in the top right corner → Copy Login Command とクリックします。
- Finish をクリックします。
新たに追加されたコネクションが OpenShift Explorer ビューに表示されます。
2.1.2. 新規 OpenShift Container Platform プロジェクトの作成
OpenShift Container Platform の通常ユーザーのリソースへのアクセスを一元管理するには、追加のアノテーションを持つ namespace である OpenShift Container Platform プロジェクトを作成する必要があります。
前提条件
OpenShift Container Platform コネクション。
新たに OpenShift Container Platform コネクションを作成する方法の詳細は、「新規 OpenShift Container Platform コネクションの作成」を参照してください。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Explorer を選択します。
Open をクリックします。
OpenShift Explorer ビューが表示されます。
OpenShift Container Platform connection → New → Project を右クリックします。
New OpenShift Project ウインドウが表示されます。
- プロジェクトに名前を付けます。
- Finish をクリックします。
新たに作成された OpenShift プロジェクトが OpenShift Explorer ビューに表示されます。
2.1.3. 新規 OpenShift Container Platform アプリケーションの作成
CodeReady Studio の OpenShift Application ウィザードを使用して、デフォルトまたはカスタムテンプレートから OpenShift Container Platform アプリケーションを作成できます。
前提条件
OpenShift Container Platform コネクション。
新たに OpenShift Container Platform コネクションを作成する方法の詳細は、「新規 OpenShift Container Platform コネクションの作成」を参照してください。
OpenShift Container Platform プロジェクト。
新たに OpenShift Container Platform プロジェクトを作成する方法の詳細は、「新規 OpenShift Container Platform プロジェクトの作成」を参照してください。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Explorer を選択します。
Open をクリックします。
OpenShift Explorer ビューが表示されます。
OpenShift Container Platform connection → New → Application を右クリックします。
Select template ウインドウが表示されます。
- テンプレートを選択します。
Next をクリックします。
Template Parameters ウインドウが表示されます。
- テンプレートパラメーターが正しいことを確認します。
Next をクリックします。
Resource Labels ウィンドウが表示されます。
- Add をクリックしてラベルを追加します。
Finish をクリックします。
Create Application Summary ウィンドウが表示されます。
- アプリケーションの詳細が正しいことを確認します。
OK をクリックします。
Import OpenShift Application ウインドウが表示されます。
- git リポジトリーをクローンする場所を選択します。
- Finish をクリックします。
新たに作成された OpenShift Container Platform アプリケーションが OpenShift Explorer ビューに表示されます。
その他のリソース
- OpenShift Container Platform でテンプレートを使用および作成する方法については、アップストリームのドキュメント「Official OKD documentation, Using templates」を参照してください。
2.1.4. 既存の OpenShift Container Platform アプリケーションの CodeReady Studio へのインポート
CodeReady Studio の OpenShift Explorer ビューには、OpenShift Container Platform アカウントに関連付けられたアプリケーションが表示されます。Import OpenShift Application ウィザードを使用すると、これらのアプリケーションのソースコードを個別に CodeReady Studio にインポートできます。アプリケーションをインポートした後、アプリケーションのソースコードの変更、アプリケーションのビルド、およびWeb ブラウザーでの表示を簡単に行うことができます。
前提条件
-
CodeReady Studio にインポートするアプリケーションのソースは
build config
ファイルに指定されている必要があります。 OpenShift Container Platform コネクション。
OpenShift Container Platform コネクションを作成する方法の詳細は、「新規 OpenShift Container Platform コネクションの作成」を参照してください。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Explorer を選択します。
Open をクリックします。
OpenShift Explorer ビューが表示されます。
OpenShift Container Platform connection → Import OpenShift Application を右クリックします。
Select Build Config ウインドウが表示されます。
- インポートするアプリケーションを選択します。
Next をクリックします。
Import OpenShift Application ウインドウが表示されます。
- Git Clone Location を選択します。
- Finish をクリックします。
新たにインポートされた OpenShift Container Platform アプリケーションが OpenShift Explorer ビューに表示されます。
2.1.5. サーバーアダプターを使用したアプリケーションのデプロイ
サーバーアダプターを使用すると、ワークスペースプロジェクトに追加した変更を OpenShift インスタンス上で実行中の OpenShift アプリケーションにパブリッシュできます。これにより、アプリケーションの変更部分を OpenShift にデプロイされた Pod に直接デプロイできます。サーバーアダプターを使用すると、ソースコードを Git リポジトリーにコミットせずに、アプリケーションの変更を直接実行中の OpenShift アプリケーションにプッシュできます。
前提条件
OpenShift Container Platform コネクション。
OpenShift Container Platform コネクションを作成する方法の詳細は、「新規 OpenShift Container Platform コネクションの作成」を参照してください。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Explorer を選択します。
Open をクリックします。
OpenShift Explorer ビューが表示されます。
- OpenShift Container Platform コネクションを展開します。
application → Server Adapterを右クリックします。
Server Settings ウィンドウが表示されます。
注記EAP 7.3 を使用している場合は、テンプレートの変更によりサーバーアダプターのデプロイメントのパスを設定する必要があります。
これを行うには、Use inferred Pod Deployment Path チェックボックスのチェックマークを削除し、Pod Deployment Path フィールドを
/opt/eap/standalone/deployments/
に設定します。- Finish をクリックします。
Servers ビューが表示され、サーバーアダプターを起動します。
ブラウザーでアプリケーションを開くには、 application → Show In → Web Browser を右クリックします。
CodeReady Studio の組み込み Web ブラウザーが開かれ、アプリケーションが表示されます。
2.1.6. OpenShift Container Platform プロジェクトの削除
プロジェクトの開発を新たに開始する場合や、プロジェクトの開発が終了した後に、ワークスペースからプロジェクトを削除することがあります。プロジェクトを削除すると、プロジェクトに関連付けられたリソースもすべて削除されます。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Explorer を選択します。
Open をクリックします。
OpenShift Explorer ビューが表示されます。
- OpenShift Container Platform コネクションを展開します。
project → Delete を右クリックします。
Delete OpenShift Resource ウィンドウに同意を求めるプロンプトが表示されます。
- OK をクリックします。
これでプロジェクトが削除されます。
2.2. CodeReady Studio での OpenShift Container Platform アプリケーションの設定およびリモート監視
CodeReady Studio を使用すると、ユーザーは OpenShift Container Platform のリモートインスタンスへのコネクションを設定し、アプリケーションを使用して、ログをビルドし、実行中のアプリケーションをトラブルシューティングおよび監視できます。
2.2.1. OpenShift Client Binaries の設定
前提条件
ポート転送の設定や、アプリケーションおよびビルドログのストリーミングを行う前に、OpenShift Client Binaries を設定します。
手順
- CodeReady Studio を起動します。
Window → Preferences をクリックします。
Preferences ウィンドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift を選択します。
-
Browse をクリックして、
oc
実行可能ファイルを見つけます。 - Apply and Close をクリックします。
これで、OpenShift Client Binaries が設定されます。
2.2.2. ポート転送の設定
Application Port Forwarding ウィンドウを使用すると、ローカルポートをリモートポートに接続し、データのアクセスやアプリケーションのデバッグを行うことができます。
以下のいずれかの理由で、ポート転送は自動的に停止します。
- OpenShift Container Platform コネクションの終了
- CodeReady Studio のシャットダウン
- ワークスペースの変更
ポート転送は、CodeReady Studio から OpenShift Container Platform に接続するたびに有効にする必要があります。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Explorer を選択します。
Open をクリックします。
OpenShift Explorer ビューが表示されます。
- OpenShift Container Platform コネクションを展開します。
application → Port Forwarding を右クリックします。
Port Forwarding ウィンドウが表示されます。
- Find free local ports for remote ports ボックスを選択します。
- Start All をクリックします。
- OK をクリックします。
Console ビューが表示され、ポート転送の開始プロセスが表示されます。
2.2.3. Pod ログのストリーミング
Pod ログは、リモート OpenShift Container Platform インスタンスで実行されるアプリケーションの一般的なログです。CodeReady Studio のストリーミング Pod ログ機能は、アプリケーションを監視し、アプリケーションが失敗したりエラーを返した場合に以前の Pod ログを使用してトラブルシューティングを行います。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Explorer を選択します。
Open をクリックします。
OpenShift Explorer ビューが表示されます。
- OpenShift Container Platform コネクションを展開します。
- application → Pod Log を右クリックします。
Console ビューが表示され、Pod ログが表示されます。
2.2.4. ビルドログのストリーミング
ビルドログは、リモート OpenShift Container Platform インスタンスで実行されているアプリケーションへの変更を記録するログです。CodeReady Studio のストリーミングビルドログ機能は、アプリケーションのビルドプロセスの進捗や、アプリケーションのデバッグに使用されます。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに OpenShift と入力します。
- OpenShift Explorer を選択します。
Open をクリックします。
OpenShift Explorer ビューが表示されます。
- OpenShift Container Platform コネクションを展開します。
- application → Build Log を右クリックします。
Console ビューが表示され、ビルドログが表示されます。
2.3. その他のリソース
- OpenShift Application Explorer の詳細は、『Getting started with CodeReady Studio Tools』を参照してください。
第3章 CodeReady Studio での Docker による開発
3.1. Docker コネクションの管理
3.1.1. Docker アカウントの設定
CodeReady Studio で Docker アカウントを設定する方法を説明します。
前提条件
Docker がシステムにインストールされている。
Docker のインストール方法は、Docker Docs の「Get Docker」を参照してください。
Docker ID を持っている。
Docker ID を取得する方法の詳細は「Register for a Docker ID」を参照してください。
手順
- CodeReady Studio を起動します。
Window → Preferences をクリックします。
Preferences ウィンドウが表示されます。
- 検索フィールドに Registry Accounts と入力します。
- Registry Accounts を選択します。
Add をクリックします。
New Registry Account ウィンドウが表示されます。
- Server Address を入力します。
- Docker ID を Username として入力します。
- Docker アカウントに関連するメールを入力します。
- パスワードを入力します。
- OK をクリックします。
- Apply and Close をクリックします。
Docker アカウントが設定されます。
3.1.2. 既存の Docker コネクションのテスト
前提条件
CodeReady Studio で Docker アカウントが設定されている。
CodeReady Studio に Docker アカウントを設定する方法の詳細は、「Docker アカウントの設定」を参照してください。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Docker と入力します。
- Docker Explorer を選択します。
Open をクリックします。
Docker Explorer ビューが表示されます。
Docker socket → Edit を右クリックします。
Edit Docker Connection ウインドウが表示されます。
Test Connection をクリックします。
コネクションが正しく設定されていれば、Ping succeeded! を示すウィンドウが表示されます。
- OK をクリックします。
- Finish をクリックします。
3.1.3. Docker コネクションの編集
前提条件
CodeReady Studio に Docker アカウントが設定されている。
CodeReady Studio に Docker アカウントを設定する方法の詳細は、「Docker アカウントの設定」を参照してください。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Docker と入力します。
- Docker Explorer を選択します。
Open をクリックします。
Docker Explorer ビューが表示されます。
Docker socket → Edit を右クリックします。
Edit Docker Connection ウインドウが表示されます。
- Unix socket Location フィールドで Browse をクリックして新しいソケットを見つけるか、TCP Connection オプションを選択してホスト URI を追加します。
- Finish をクリックします。
Docker コネクションが編集されます。
3.2. Docker イメージの管理
3.2.1. Docker イメージのプル
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Docker と入力します。
- Docker Explorer を選択します。
Open をクリックします。
Docker Explorer ビューが表示されます。
- Docker socket フォルダーを展開します。
Images → Pull を右クリックします。
Pull Image ウインドウが表示されます。
Search をクリックします。
Search the Docker Registry for images ウィンドウが表示されます。
- 検索フィールドにイメージ名を入力します。
Next をクリックします。
Choose a tag for the selected image ウィンドウが表示されます。
- イメージのタグを選択します。
Finish をクリックします。
Pull an image or a repository from the registry ウインドウが表示されます。
- Finish をクリックします。
新しい Docker イメージが Docker Explorer ビューに表示されます。
3.2.2. Docker イメージのプッシュ
イメージをプッシュする前に、タグを付ける必要があります。CodeReady Studio で Docker イメージにタグを付け、プッシュする方法を説明します。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Docker と入力します。
- Docker Explorer を選択します。
Open をクリックします。
Docker Explorer ビューが表示されます。
- Docker socket → Images を展開します。
- タグを付けるイメージを右クリックします。
Add tag をクリックします。
Tag Image ウインドウが表示されます。
タグを New Tag フィールドに入力します。
タグは
username/image_name:tag_name
の形式で指定する必要があります。ここで、username
は hub.docker.com 上の Docker ID、image_name
はイメージの名前、tag_name
はイメージのバージョンに置き換えます。- Finish をクリックします。
tagged image → Push を右クリックします。
Push image to Registry ウインドウが表示されます。
- Docker ID で始まる Registry Account を選択します。
- Finish をクリックします。
イメージをプッシュすると、Docker Cloud に表示されます。その後、このイメージは他の開発者が使用できるようになります。
3.2.3. Docker イメージの実行
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Docker と入力します。
- Docker Explorer を選択します。
Open をクリックします。
Docker Explorer ビューが表示されます。
- Docker socket → Images を展開します。
- 実行するイメージを右クリックします。
Run クリックします。
Docker Container settings ウィンドウが表示されます。
- コンテナーに名前を付けます。
- Publish all exposed ports to random ports on the host interfaces チェックボックスを非選択にします。
-
8080
ポートのボックスを選択します。 Finish をクリックします。
Console ビューが表示され、イメージを起動するプロセスが表示されます。
Web ブラウザーで http://localhost:8080/ に移動し、実行中のイメージを確認します。
3.2.4. Dockerfile でのイメージのビルド
既存のイメージを変更して、イメージをビルドまたは作成できます。通常、これには新しいパッケージをインストールする必要があります。新しい Docker イメージの指定は、Dockerfile
で行います。
前提条件
ローカルマシンに Dockerfile が作成されている。
Dockerfile の作成方法についての詳細は、「Dockerfile の作成」を参照してください。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Docker と入力します。
- Docker Images を選択します。
Open をクリックします。
Docker Images ビューが表示されます。
イメージの Build Image アイコンをクリックします。
Build a Docker Image ウィンドウが表示されます。
-
repo/name:version
の形式で、イメージに名前を付けます。 - Browse をクリックして Dockerfile を見つけます。
- Finish をクリックします。
Console ビューが表示され、ビルドのプロセスが表示されます。
3.3. Docker コンテナーの管理
Docker コンテナーは、Docker イメージを基にした分離されたプロセスです。コンテナーの作成後、ユーザーはコンテナーを停止、起動、一時停止、一時停止解除、kill、または削除できます。また、コンテナーのログの読み取りも可能です。
CodeReady Studio で Docker コンテナーを管理する方法を説明します。
手順
- CodeReady Studio を起動します。
Window → Show View → Other とクリックします。
Show View ウインドウが表示されます。
- 検索フィールドに Docker と入力します。
- Docker Containers を選択します。
Open をクリックします。
Docker Containers ビューが表示されます。
パネルを使用して、コンテナーを起動、一時停止、一時停止解除、停止、kill、再開、削除、または更新できます。