クラウド・シェルの使用

クラウド・シェルには2つの方法でアクセスできます:

• OCIコンソールを使用します
• ドキュメント全体の多くのコマンドラインおよびコード・サンプルに表示される「試してみる」ボタンを使用します

コンソールを使用してクラウド・シェルにアクセスするには:

1. コンソールにログインします。
2. コンソール・ヘッダーの「クラウド・シェル/コード・エディタ」アイコンをクリックし、ドロップダウン・メニューから「クラウド・シェル」を選択します。クラウド・シェルで実行中のOCI CLIでは、クラウド・シェルの起動時に、コンソールの「リージョン」選択メニューで選択されているリージョンに対してコマンドが実行されることに注意してください。

これにより、コンソール下部のドロワーにクラウド・シェルが表示されます:

「クラウド・シェル」ウィンドウの右上隅にあるアイコンを使用すると、クラウド・シェル・セッションを最小化、最大化、再起動および閉じることができます。

キーボードを使用してCloud Shellからフォーカスを移動するには、[Ctrl]を押しながら[Esc]を押します。

「試してみる」ボタンを使用してクラウド・シェルにアクセスするには:

OCIドキュメントの多くのコードおよびコマンド・サンプルに「試してみる」ボタンが含まれます。このボタンにより、サンプルがクリップボードにコピーされ、クラウド・シェル・セッションが開き、サンプルを試してみることができます。

クラウド・シェルには事前認証済のOCI CLIが用意されているため、使用を開始する前に必要な設定はありません。

次のコマンドで試してください:

oci os ns get

oci iam compartment list

メニューを使用してクラウド・シェルにファイルをアップロードするには:

1. 「クラウド・シェル」ウィンドウの左上にある「クラウド・シェル」メニューをクリックし、「アップロード」を選択します。「ファイルのアップロード」ダイアログが表示されます。
2. ファイルをドラッグ・アンド・ドロップするか、「コンピュータから選択」をクリックします。
   ノート
   
   「ファイルの転送」ダイアログで選択して転送できるのは、一度に1つのファイルのみです。
3. 「アップロード」ボタンをクリックします。
4. 「ファイルの転送」ダイアログが表示されます。
   1. 処理中のファイル転送が進捗バーで表示されます
   2. ファイルの進捗バーの横にある「X」をクリックすると、処理中のファイル転送を取り消すことができます
   3. 完了したファイル転送には、緑色のチェック・マークが表示されます
   4. 「ファイルの転送」ダイアログを非表示にするには、「非表示」をクリックします
   5. 「クラウド・シェル」メニューから「ファイルの転送」を選択すると、「ファイルの転送」ダイアログをいつでも表示できます

クラウド・シェルからファイルをダウンロードするには:

1. 「クラウド・シェル」ウィンドウの左上にある「クラウド・シェル」メニューをクリックし、「ダウンロード」を選択します。「ファイルのダウンロード」ダイアログが表示されます:
2. ホーム・ディレクトリにある、ダウンロード対象のファイルの名前を入力します。
   ノート
   
   ファイルをダウンロードできるのは、ホーム・ディレクトリからのみです。
3. 「ダウンロード」ボタンをクリックします。
4. 「ファイルの転送」ダイアログが表示されます。
   1. 処理中のファイル転送が進捗バーで表示されます
   2. ファイルの進捗バーの横にある「X」をクリックすると、処理中のファイル転送を取り消すことができます
   3. 完了したファイル転送には、緑色のチェック・マークが表示されます
   4. 「ファイルの転送」ダイアログを非表示にするには、「非表示」をクリックします
   5. 「クラウド・シェル」メニューから「ファイルの転送」を選択すると、「ファイルの転送」ダイアログをいつでも表示できます

クラウド・シェルには、事前認証済のOCI CLIが付属しています。新規クラウド・シェルを開いたとき、このCLIはユーザーに対してリフレッシュおよびプロビジョニングされます。OCI構成の場所とトークンは、/etc/ociのユーザーのホーム・ディレクトリの外部にあります。例:

            example_user@cloudshell:~ (us-ashburn-1)$ ll /etc/oci
            total 20K
            drwxrwx---. 1 root oci 44 Oct 12 00:07 ./
            drwxr-xr-x. 1 root root 4.0K Oct 12 00:07 ../
            -rw-------. 1 jonathan_s oci 1.9K Jan 1 1970 config
            -rw-------. 1 jonathan_s oci 1.3K Jan 1 1970 delegation_token
            example_user@cloudshell:~ (us-ashburn-1)$

構成ファイルの場所、OCI CLI認証タイプおよびプロファイル選択は、環境変数を使用して指定されます:

OCI_CLI_AUTH=instance_obo_user
            OCI_CLI_CONFIG_FILE=/etc/oci/config
            OCI_CLI_PROFILE=us-ashburn-1

OCI CLIをカスタマイズするには、OCI CLIのRCファイルを作成し、これをローカルの.ociディレクトリに配置します:

$ oci setup oci-cli-rc --file path/to/target/file

OCI CLIの構成の詳細は、CLIの構成を参照してください。

クラウド・シェルでは、CLI構成ファイルおよびENV変数を使用して、OCI CLIが相互作用するリージョンを決定します。OCI CLI構成ファイル(環境変数OCI_CLI_CONFIG_FILEで指定)には、クラウド・シェルのCLIプロファイルが含まれます。各リージョンに独自のCLIプロファイルがあり、現在のプロファイルはOCI_CLI_PROFILE環境変数を介して指定されます。

たとえば、コンソールの「リージョン」ドロップダウンで「米国東部(アッシュバーン)」が選択された状態で、コンソールからクラウド・シェルを開くと、OCI_CLI_PROFILEがus-ashburn-1に設定された状態でクラウド・シェルが開きます。

クラウド・シェルでOCI CLI設定をカスタマイズする場合は、OCI CLI構成ファイルを使用できます。たとえば、RCファイルの該当するリージョン・プロファイルの下で、構成ファイルにデフォルト・コンパートメントを設定するとします。「us-ashburn-1」の例では、このようなデフォルト・コンパートメント設定を追加できます:

[COMPARTMENT DEFAULTS]
[us-ashburn-1]
compartment-id = ocid1.compartment.oc1..xxxxxxxx

csresetツールを使用して、クラウド・シェル環境をデフォルト状態にリセットできます。bashプロファイルおよびemacs設定のみをリセットすることも、ホーム・ディレクトリ内のすべてのデータを削除してbashおよびemacs設定をリセットすることもできます。

csreset --bashfiles

csreset -b

csreset --all

csreset -a

csreset -h

csreset --help

クラウド・シェルのホーム・ディレクトリの内容をアーカイブして、オブジェクト・ストレージのバケットにバックアップできます。

クラウド・シェルには、OKEで現在サポートされている各Kubernetesのバージョンが事前にインストールされています。これらのバージョンは/usr/local/bin/kubectl-{version} (/usr/local/bin/kubectl-v1.17.13など)にインストールされおり、バイナリへのパスはPATH環境変数に含まれます。

デフォルトでは、クラウド・シェルのセッションでkubectlを実行すると、インストールされたkubectlのうち2番目に新しいバージョンが起動されます。これは、Kubernetesのバージョン・スキュー・ポリシーに基づき、互換性の最適化を目的として行っています。

デフォルトではないバージョンのkubectlを使用する場合は、バージョン固有のバイナリを起動できます。

kubectl-v1.17.13 get services

alias kubectl=kubectl-v1.17.13

csruntimectl java list

csruntimectl java set oraclejdk-11

この設定は、クラウド・シェルのセッション全体で保持されることに注意してください。

csruntimectl help