IBM Cloud Shell 入門

このチュートリアルでは、IBM® Cloud Shell を使用して、サンプルの Node.js アプリをクローンします。IBM Cloud Shellは、ブラウザからアクセスできるクラウドベースのシェルワークスペースです。Cloud Shell は、完全な IBM Cloud CLI と、アプリ、リソース、インフラストラクチャの管理に使用できる大量のプラグインとツールで構成済みです。

Cloud Shell を初めて使用する場合は、デモビデオを見て、IBM Cloudコンソールからサービスを使い始める方法をご覧ください。

開始前に

IBM Cloud のアカウントをお持ちでない場合は、登録してログインしてください。
Cloud Shell とその機能へのアクセス権限に影響を与える可能性がある以下のアカウント・アクセス情報に注意してください。
- アカウント・レベルで Cloud Shell の設定が無効になっていても、アカウント管理者は、特定のユーザーに Cloud Shell とその機能に対するアクセス権限を付与することができます。詳しくは、ユーザー・レベルでの Cloud Shell とそのフィーチャーへのアクセスの割り当てを参照してください。
- アカウント所有者または Cloud Shell 管理者権限を持つユーザーは、アカウントに対して Cloud Shell 機能を有効または無効にすることができます。このリリースでは、ファイルのアップロード/ダウンロード機能と Web プレビュー機能が利用可能になりました。機能の設定は、有効にされている Cloud Shell ロケーションにのみ適用されます。詳しくは、アカウントに対する Cloud Shell フィーチャーの有効化または無効化を参照してください。
- 詳しくは、IAM の役割とアクションを参照してください。

IBM Cloud Shell でのセッションの開始

IBM Cloud コンソールで、IBM Cloud Shell アイコンをクリックします。セッションが開始され、IBM Cloud CLI により自動的にログインします。

Node.js サンプル・アプリの複製

Cloud Shell セッションは、一時ホーム・ディレクトリー /home/<user-name>で開始されます。 Node.js Expressのサンプルアプリをこのディレクトリにコピーし、以下のコマンドを実行してサンプルアプリのディレクトリに変更します。

git clone https://github.com/IBM/nodejs-express-app.git

cd nodejs-express-app

アプリのディレクトリーから、以下のコマンドを実行して新しいファイルを表示します。

ls

nodejs-express-app ディレクトリーにすべてのサンプル・アプリ・ファイルおよびフォルダーが含まれていることが示されます。

Dockerfile  Dockerfile-tools  LICENSE  README.md  package-lock.json
package.json  public  scripts  server  test

ローカルでのアプリのプレビュー

Cloud Shell で開始し、ローカルでプレビューすることができます。

まず、Node.js サンプル・アプリのプロジェクト依存関係をダウンロードします。
```
npm install --only=prod
```
アプリを開始します。
```
npm run start
```
アプリが実行されると、アプリの UI を利用できる場所が出力されます。 Cloud Shell の場合、ポートのみをメモする必要があります。この場合、 3000 です。
```
> nodejsexpressapp@1.0.0 start /home/my-user-name/nodejs-express-app
> node server/server.js

App UI available http://localhost:3000
Swagger UI available http://localhost:3000/swagger/api-docs
```
Cloud Shell メニュー・バーで、Web プレビュー アイコンをクリックし、ポート 3000 を選択します。

アプリのプレビューが、新しいウィンドウで開かれます。「Congratulations」メッセージが表示されたら、アプリは Cloud Shell でローカルに実行されています。
Control+C を押してアプリを停止します。

次のステップ

Cloud Shell から、IBM Cloud アカウント上でコマンドを即時に実行できます。以下に例を示します。

IBM Cloud は、Cloud Shell CLI に加えて、クラウド内での作業に役立つすべての IBM Cloud CLI プラグインや多数のツールとランタイムを含むように事前構成されています。完全なリストについては、インストール済みのプラグインとツールを参照してください。