翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Code Editor の使用 このセクションのトピックでは、Code Editor の起動、接続の追加、リソースの AWS のサービスシャットダウンなどの使用方法について説明します。Code Editor スペースを作成したら、ブラウザから直接 Code Editor セッションにアクセスできます。 Code Editor 環境では、以下を実行できます。 + ホームディレクトリに保持されているすべてのアーティファクトにアクセスする + GitHub リポジトリのクローンを作成し、変更をコミットする + SageMaker Python SDK にアクセスする Studio に戻って、実験、パイプライン、トレーニングジョブなど、Code Editor 環境で作成されたアセットを確認できます。 **Topics** + [Code Editor のバージョンを確認する](code-editor-use-version.md) + [Code Editor アプリケーションインスタンスとイメージ](code-editor-use-instances.md) + [Studio で Code Editor アプリケーションを起動する](code-editor-use-studio.md) + [を使用して Code Editor アプリケーションを起動する AWS CLI](code-editor-launch-cli.md) + [Code Editor でリポジトリのクローンを作成する](code-editor-use-clone-a-repository.md) + [Code Editor の接続と拡張機能](code-editor-use-connections-and-extensions.md) + [Code Editor リソースをシャットダウンする](code-editor-use-log-out.md) # Code Editor のバージョンを確認する 次の手順は、Code Editor アプリケーションのバージョンを確認する方法を示しています。 **Code Editor アプリケーションのバージョンを確認するには** 1. Code Editor スペースを起動して実行し、Code Editor アプリケーション UI に移動します。詳細については、「[Studio で Code Editor アプリケーションを起動する](code-editor-use-studio.md)」を参照してください。 1. Code Editor UI の左上隅で、メニューボタン (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/code-editor/code-editor-menu-icon.png)) を選択します。次に、**[ヘルプ]** を選択し、**[バージョン情報]** を選択します。 # Code Editor アプリケーションインスタンスとイメージ Code Editor アプリケーションに対応しているのは一部のインスタンスのみです。**[インスタンス]** ドロップダウンメニューから、ユースケースに対応するインスタンスタイプを選択できます。 **[高速起動]** インスタンスは、他のインスタンスよりもはるかに高速に起動します。Studio での高速起動インスタンスタイプの詳細については、「[Amazon SageMaker Studio Classic ノートブックで使用できるインスタンスタイプ](notebooks-available-instance-types.md)」を参照してください。 **注記** Code Editor アプリケーションを設定するときに GPU インスタンスタイプを使用する場合は、GPU ベースのイメージを使用する必要があります。Code Editor スペース UI では、インスタンスタイプを選択すると、対応するイメージが自動的に選択されます。 スペース内では、データはインスタンスの存続期間とは別に保持される Amazon EBS ボリュームに保存されます。インスタンスを変更しても、データは失われません。Code Editor のスペースが `Running` の場合は、インスタンスタイプを変更する前にスペースを停止する必要があります。 次の表に、各リージョンで使用可能な Code Editor CPU イメージと GPU イメージの ARN を示します。 | リージョン | CPU | GPU | | --- | --- | --- | | us-east-1 | arn:aws:sagemaker:us-east-1:885854791233:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-east-1:885854791233:image/sagemaker-distribution-gpu | | us-east-2 | arn:aws:sagemaker:us-east-2:37914896644:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-east-2:37914896644:image/sagemaker-distribution-gpu | | us-west-1 | arn:aws:sagemaker:us-west-1:053634841547:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-west-1:053634841547:image/sagemaker-distribution-gpu | | us-west-2 | arn:aws:sagemaker:us-west-2:542918446943:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-west-2:542918446943:image/sagemaker-distribution-gpu | | af-south-1 | arn:aws:sagemaker:af-south-1:238384257742:image/sagemaker-distribution-cpu | arn:aws:sagemaker:af-south-1:238384257742:image/sagemaker-distribution-gpu | | ap-east-1 | arn:aws:sagemaker:ap-east-1:523751269255:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-east-1:523751269255:image/sagemaker-distribution-gpu | | ap-south-1 | arn:aws:sagemaker:ap-south-1:245090515133:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-south-1:245090515133:image/sagemaker-distribution-gpu | | ap-northeast-2 | arn:aws:sagemaker:ap-northeast-2:064688005998:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-2:064688005998:image/sagemaker-distribution-gpu | | ap-southeast-1 | arn:aws:sagemaker:ap-southeast-1:022667117163:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-1:022667117163:image/sagemaker-distribution-gpu | | ap-southeast-2 | arn:aws:sagemaker:ap-southeast-2:648430277019:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-2:648430277019:image/sagemaker-distribution-gpu | | ap-northeast-1 | arn:aws:sagemaker:ap-northeast-1:010972774902:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-1:010972774902:image/sagemaker-distribution-gpu | | ca-central-1 | arn:aws:sagemaker:ca-central-1:481561238223:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ca-central-1:481561238223:image/sagemaker-distribution-gpu | | eu-central-1 | arn:aws:sagemaker:eu-central-1:545423591354:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-central-1:545423591354:image/sagemaker-distribution-gpu | | eu-west-1 | arn:aws:sagemaker:eu-west-1:819792524951:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-1:819792524951:image/sagemaker-distribution-gpu | | eu-west-2 | arn:aws:sagemaker:eu-west-2:021081402939:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-2:021081402939:image/sagemaker-distribution-gpu | | eu-west-3 | arn:aws:sagemaker:eu-west-3:856416204555:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-3:856416204555:image/sagemaker-distribution-gpu | | eu-north-1 | arn:aws:sagemaker:eu-north-1:175620155138:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-north-1:175620155138:image/sagemaker-distribution-gpu | | eu-south-1 | arn:aws:sagemaker:eu-south-1:810671768855:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-south-1:810671768855:image/sagemaker-distribution-gpu | | sa-east-1 | arn:aws:sagemaker:sa-east-1:567556641782:image/sagemaker-distribution-cpu | arn:aws:sagemaker:sa-east-1:567556641782:image/sagemaker-distribution-gpu | | ap-northeast-3 | arn:aws:sagemaker:ap-northeast-3:564864627153:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-3:564864627153:image/sagemaker-distribution-gpu | | ap-southeast-3 | arn:aws:sagemaker:ap-southeast-3:370607712162:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-3:370607712162:image/sagemaker-distribution-gpu | | me-south-1 | arn:aws:sagemaker:me-south-1:523774347010:image/sagemaker-distribution-cpu | arn:aws:sagemaker:me-south-1:523774347010:image/sagemaker-distribution-gpu | | me-central-1 | arn:aws:sagemaker:me-central-1:358593528301:image/sagemaker-distribution-cpu | arn:aws:sagemaker:me-central-1:358593528301:image/sagemaker-distribution-gpu | | il-central-1 | arn:aws:sagemaker:il-central-1:080319125002:image/sagemaker-distribution-cpu | arn:aws:sagemaker:il-central-1:080319125002:image/sagemaker-distribution-gpu | | cn-north-1 | arn:aws:sagemaker:cn-north-1:674439102856:image/sagemaker-distribution-cpu | arn:aws:sagemaker:cn-north-1:674439102856:image/sagemaker-distribution-gpu | | cn-northwest-1 | arn:aws:sagemaker:cn-northwest-1:651871951035:image/sagemaker-distribution-cpu | arn:aws:sagemaker:cn-northwest-1:651871951035:image/sagemaker-distribution-gpu | | us-gov-west-1 | arn:aws:sagemaker:us-gov-west-1:300992924816:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-gov-west-1:300992924816:image/sagemaker-distribution-gpu | | us-gov-east-1 | arn:aws:sagemaker:us-gov-east-1:300993876623:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-gov-east-1:300993876623:image/sagemaker-distribution-gpu | インスタンスの制限が発生した場合は、管理者に連絡してください。ユーザーのストレージとコンピューティングを増やすために、管理者はユーザーの AWS クォータの引き上げをリクエストできます。クォータの引き上げリクエストの詳細については、「[Amazon SageMaker エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/sagemaker.html)」を参照してください。 # Studio で Code Editor アプリケーションを起動する Studio を使って Code Editor 統合開発環境を設定し、アクセスするには、Code Editor スペースを作成する必要があります。Studio のスペースの詳細については、「[Amazon SageMaker Studio のスペース](studio-updated-spaces.md)」を参照してください。 ![\[Studio UI の Code Editor アプリケーションボタンと概要タイル。\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/code-editor/code-editor-studio-home.png) 次の手順は、Code Editorスペースを作成して実行する方法を示しています。 **Code Editor スペースを作成して実行するには** 1. 更新された Studio エクスペリエンスを起動します。詳細については、「[Launch Amazon SageMaker Studio](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-launch.html)」を参照してください。 1. 次のいずれかを行います。 + 更新された Amazon SageMaker Studio UI で、**[アプリケーション]** メニューから **[Code Editor]** を選択します。 + 更新された Amazon SageMaker Studio UI で、Studio ホームページの **[概要]** セクションにある **[Code Editor スペースを表示]** を選択します。 1. Code Editor ランディングページの右上隅で、**[Code Editor スペースを作成]** を選択します。 1. Code Editor スペースの名前を入力します。名前の長さは 1 ～ 62 文字で、文字、数字、ダッシュのみを使用する必要があります。 1. **[スペースを作成]** を選択します。 1. スペースが作成されたら、スペースを実行する前にいくつかのオプションがあります。 + **[ストレージ (GB)]**、**[ライフサイクル設定]** または **[カスタム EFS ファイルシステムのアタッチ]** の各設定を編集できます。これらの設定のオプションは、管理者が指定した内容に基づいて使用できます。 + **[インスタンス]** ドロップダウンメニューから、ユースケースに最も対応するインスタンスタイプを選択できます。**[イメージ]** ドロップダウンメニューから、SageMaker Distribution イメージまたは管理者が提供するカスタムイメージを選択できます。 **注記** sagemaker-distribution イメージ間で切り替えを行うと、使用される Code Editor の基盤となるバージョンが変更され、ブラウザキャッシュによる非互換性が生じる可能性があります。イメージを切り替える際は、ブラウザキャッシュをクリアする必要があります。 Code Editor アプリケーションを設定するときに GPU インスタンスタイプを使用する場合は、GPU ベースのイメージを使用する必要があります。スペース内では、データはインスタンスの存続期間とは別に保持される Amazon EBS ボリュームに保存されます。インスタンスを変更しても、データは失われません。 **重要** カスタムイメージを表示するためには、Studio ユーザーにスペースの作成を許可するカスタム IAM ポリシーで、イメージを一覧表示するアクセス許可 (`sagemaker: ListImage`) も付与する必要があります。アクセス許可を追加するには、「*AWS Identity and Access Management* ユーザーガイド」の「[アクセス許可の追加および削除](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)」を参照してください。 SageMaker AI リソースを作成するためのアクセス許可を付与する [AWS Amazon SageMaker AI の マネージドポリシー](security-iam-awsmanpol.md)には、それらのリソースの作成中にイメージを一覧表示するアクセス許可が既に含まれています。 **注記** スペース設定を更新するには、まずスペースを停止する必要があります。NVMe インスタンスストアを使用するインスタンスを Code Editor で使う場合、NVMe ストアに保存されているデータは、スペースが停止すると削除されます。 1. 設定を更新したら、スペースの詳細ページで **[実行スペース]** を選択します。 1. スペースのステータスが `Running` になったら、**[Code Editor を開く]** を選択して Code Editor セッションに移動します。 ![\[Studio UI の Code Editor アプリケーションのスペースの詳細ページ。\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/code-editor/code-editor-open.png) # を使用して Code Editor アプリケーションを起動する AWS CLI AWS Command Line Interface (AWS CLI) を使用して Code Editor 統合開発環境を設定し、アクセスするには、Code Editor スペースを作成する必要があります。次のステップに進む前に、必ず「[前提条件を満たす](code-editor-admin-prerequisites.md)」に従ってください。Code Editor スペースを作成して実行するには、次の手順に従います。 **Code Editor スペースを作成して実行するには** 1. AWS Identity and Access Management (IAM) または AWS IAM アイデンティティセンター 認証を使用してスペースにアクセスします。を使用してスペースにアクセスする方法の詳細については AWS CLI、*「」の「 を使用してスペースにアクセスする AWS Command Line Interface*」を参照してください[Amazon SageMaker Studio のスペース](studio-updated-spaces.md)。 1. 次のコマンドを使用してアプリケーションを作成し、`app-type` として `CodeEditor` を指定します。 Code Editor アプリケーションを作成するときに GPU インスタンスタイプを使用する場合は、GPU ベースのイメージを使用する必要があります。 ``` aws sagemaker create-app \ --domain-id domain-id \ --space-name space-name \ --app-type CodeEditor \ --app-name default \ --resource-spec "SageMakerImageArn=arn:aws:sagemaker:region:account-id:image/sagemaker-distribution-cpu" ``` 使用可能な Code Editor のイメージ ARN については、「[Code Editor アプリケーションインスタンスとイメージ](code-editor-use-instances.md)」を参照してください。 1. Code Editor アプリケーションが稼働したら、署名付き URL を使用してアプリケーションを起動します。アプリケーションが稼働しているかどうかは、`describe-app` API を使用して確認できます。`create-presigned-domain-url` API を使用して署名付き URL を作成します。 ``` aws sagemaker create-presigned-domain-url \ --domain-id domain-id \ --space-name space-name \ --user-profile-name user-profile-name \ --session-expiration-duration-in-seconds 43200 \ --landing-uri app:CodeEditor: ``` 1. 生成された URL を開いて、Code Editor アプリケーションで作業を開始します。 # Code Editor でリポジトリのクローンを作成する Code Editor アプリケーション UI の **[エクスプローラー]** ウィンドウで、フォルダ間を移動したり、リポジトリのクローンを作成したりできます。 リポジトリのクローンを作成するには、次の手順を実行します。 **リポジトリのクローンを作成するには** 1. ブラウザで Code Editor アプリケーションを開き、左側のナビゲーションペインで**探索**ボタン (![\[Icon representing multiple documents or pages stacked on top of each other.\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/code-editor/code-editor-exploration-icon.png)) を選択します。 1. **[エクスプローラー]** ウィンドウで **[リポジトリのクローンを作成]** を選択します。次に、リポジトリ URL を指定するか、プロンプトでリポジトリソースを選択します。 1. リポジトリのクローンを作成するフォルダを選択します。デフォルトの Code Editor フォルダは `/home/sagemaker-user/` です。リポジトリのクローン作成には時間がかかる場合があります。 1. クローンとして作成されたリポジトリを開くには、**[新しいウィンドウで開く]** または **[開く]** を選択します。 1. Code Editor アプリケーション UI ホームページに戻るには、**[キャンセル]** を選択します。 1. 新しいリポジトリ内のファイルの作成者を信頼するかどうかをたずねるプロンプトがリポジトリで表示されます。次の 2 つの選択肢があります。 1. フォルダを信頼してすべての機能を有効にするには、**[はい、作成者を信頼します]** を選択します。 1. *制限付きモード*でリポジトリコンテンツを参照するには、**[いいえ作成者を信頼しません]** を選択します。 制限付きモードでは、タスクの実行が許可されず、デバッグが無効になります。さらに、ワークスペース設定は適用されず、拡張機能も制限されます。 制限付きモードを終了して、現在のフォルダまたはその親フォルダ内のすべてのファイルの作成者を信頼し、すべての機能を有効にするには、**制限付きモード**のバナーで **[管理]** を選択します。 # Code Editor の接続と拡張機能 Code Editor は、 への IDE 接続 AWS のサービス と [Open VSX Registry ](https://open-vsx.org/)で使用できる拡張機能をサポートしています。 ## への接続 AWS Code Editor 環境は [AWS Toolkit for VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) と統合されており、 AWS のサービスへの接続が可能になっています。への接続を開始するには AWS のサービス、有効な AWS Identity and Access Management (IAM) 認証情報が必要です。詳細については、[AWS 「 Toolkit for Visual Studio Code の認証とアクセス](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/establish-credentials.html)」を参照してください。 Code Editor 環境内で、以下のサービスへの接続を追加できます。 + [AWS Explorer ](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/aws-explorer.html) – Amazon S3、CloudWatch などの AWS リソースを表示、変更、デプロイします。 AWS Explorer 内の特定の機能にアクセスするには、特定の AWS アクセス許可が必要です。詳細については、[AWS 「 Toolkit for Visual Studio Code の認証とアクセス](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/establish-credentials.html)」を参照してください。 + [Amazon CodeWhisperer](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codewhisperer.html) – AI を活用したコード提案により、アプリケーションを迅速に構築できます。 Code Editor Amazon CodeWhisperer で を使用するには、SageMaker AI 実行ロールに次のアクセス許可を追加する必要があります。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "CodeWhispererPermissions", "Effect": "Allow", "Action": ["codewhisperer:GenerateRecommendations"], "Resource": "*" } ] } ``` ------ 詳細については、「*IAM ユーザーガイド*」の「[IAM ポリシーを作成する](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)」と「[IAM ID のアクセス許可の追加および削除](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)」を参照してください。 ## 拡張子 Code Editor は、[Open VSX Registry](https://open-vsx.org/) で利用可能な IDE 拡張機能をサポートしています。 Code Editor 環境で拡張機能を使用するには、左側のナビゲーションペインで**拡張機能**アイコン (![\[Icon showing two overlapping squares representing multiple windows or instances.\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/code-editor/code-editor-extensions-icon.png)) を選択します。ここで AWS Toolkitをインストールすることで、 AWS への接続を設定できます。詳細については、「[AWS Toolkit for Visual Studio Codeのインストール](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-toolkit.html)」を参照してください。 検索バーでは、 AWS Toolkit、Jupyter、Python など、[Open VSX Registry](https://open-vsx.org/) による追加の拡張機能を直接検索できます。 # Code Editor リソースをシャットダウンする Code Editor スペースの使用が終了したら、Studio を使用してスペースを停止できます。こうすることで、スペースのコストの発生を停止できます。 または、 AWS CLIを使用して未使用の Code Editor リソースを削除することもできます。 ## Studio を使用して Code Editor スペースを停止する Studio で Code Editor スペースを停止するには、次の手順を実行します。 **Studio で Code Editor スペースを停止するには** 1. 次のいずれかを実行して、Code Editor のランディングページに戻ります。 1. 左上隅のナビゲーションバーで、**[Code Editor]** を選択します。 1. または、左側のナビゲーションペインで、**[アプリケーション]** メニューの **[Code Editor]** を選択します。 1. 作成した Code Editor スペースの名前を見つけます。スペースのステータスが **[実行中]** の場合は、**[アクション]** 列で **[停止]** を選択します。スペースの詳細ページで **[スペースを停止]** を選択して、スペースを直接停止することもできます。スペースが停止するまでに時間がかかる場合があります。 ![\[Code Editor アプリケーション UI のスペースの詳細ページ。\]](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/code-editor/code-editor-stop-space.png) Studio から作成された SageMaker AI エンドポイント、Amazon EMR (Amazon EMR) クラスター、Amazon Simple Storage Service (Amazon S3) バケットなどの追加のリソースは、スペースインスタンスがシャットダウンしても自動的に削除されません。リソースによる料金の発生を停止するには、追加のリソースを削除します。リソースの削除については、「[Delete unused resources](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-jl-admin-guide-clean-up.html)」を参照してください。 ## を使用して Code Editor リソースを削除する AWS CLI Code Editor アプリケーションとスペースは、 AWS Command Line Interface () を使用して削除できますAWS CLI。 + [DeleteApp](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteApp.html) + [DeleteSpace](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteSpace.html)