VPC環境で利用できます。
Project Homeの Overview画面構成について説明します。Overviewタブでは Project Namespaceにアクセスできる kubeconfigをダウンロードして最近のタスク履歴を照会できます。
kubeconfigダウンロード
各プロジェクトは固有の Kubernetes Namespaceを持ち、これは Workspace内の他のプロジェクトから隔離された環境を提供します。
Project Namespaceは p-{프로젝트 이름} の形式で作成されます。
kubectlで Project Namespaceにワークロードを作成または照会するには、当該 Namespaceにアクセスできる kubeconfigファイルが必要です。kubeconfigにはユーザー本人のトークンが含まれており、トークンの権限はユーザーの Projectメンバーロール(Admin、Writer、Reader)に従います。
kubeconfig発行
kubeconfigを発行する方法は次の通りです。
- Project Homeの Overviewタブの上部にある Download Kubeconfigをクリックします。
- Kubeconfigダウンロードのポップアップでトークンの有効期間(日) に、トークンを使用する期間を入力します。
- デフォルト値は90日であり、日単位の整数で入力します。
- 入力値の下に有効期限の予定時刻が表示されます。
- ダウンロードをクリックします。
{프로젝트 이름}-kubeconfig.yamlファイルがダウンロードされます。
- API Keyとは異なり、発行された kubeconfigトークンは有効期限が切れるまでは破棄できません。必要以上に長い有効期間を設定する代わりに、ファイルが漏洩した場合は、Project Adminに当該ユーザーを Projectメンバーから除外するようリクエストしてください。メンバーから除外されると、トークンの有効期限が切れていなくても、Project Namespaceにアクセスできなくなります。
- kubeconfigはご本人のみご利用ください。他のユーザーや外部プログラムにはファイルを共有しないようにし、外部プログラムには API Keyを発行してください。
- 有効期間の最大値は、プラットフォームの運用設定によって異なる場合があります。デフォルトの上限は365日であり、上限を超えるリクエストは拒否されます。
- 有効期限が切れると、
kubectlリクエストは401エラーとして拒否されます。拒否された場合は、Overview画面から kubeconfigを再度ダウンロードし、既存のファイルを新しいファイルに置き換えてください。
有効期限の確認
有効期限は、kubeconfigファイルの先頭にあるコメントに記載されています。
head {プロジェクト名}-kubeconfig.yaml
# Expires : 2026-12-09 14:30 KST (valid for 90 days)
# Check expiry : head kubeconfig.yaml (this comment)
kubectlで ML expert Platformにアクセス
ML expert Platformは、Kubernetesクラスタ制御用の CLI kubectlを通じて利用できます。
kubectlバージョンは、クラスタの Kubernetesバージョンとマイナーバージョン1以内の範囲に合わせる必要があります(kubectl Version Skew Policy)。- クラスタの Kubernetesバージョンは kubeconfigを設定した後、
kubectl versionコマンドで確認します。
取得した kubeconfigファイルを任意のディレクトリ(例: $HOME/.kube)に移動した後、ファイルパスを環境変数 KUBECONFIGに指定します。
mkdir -p ~/.kube
mv {ダウンロードパス}/{プロジェクト名}-kubeconfig.yaml ~/.kube
export KUBECONFIG=$HOME/.kube/{プロジェクト名}-kubeconfig.yaml
kubectlを使用すると、次のようにプロジェクトにアクセスできることを確認できます。
$ kubectl -n p-{プロジェクト名} get pods
NAME READY STATUS RESTARTS AGE
ml-pipeline-ui-artifact-7496857fcc-p24rw 2/2 Running 0 5h3m
ml-pipeline-visualizationserver-5c96659f4b-d6stz 2/2 Running 0 5h3m
複数のプロジェクトを使用する場合は、プロジェクトごとの kubeconfigファイルをすべて KUBECONFIGにコロン(:)でつなげて指定し、kubectl config use-context コマンドで切り替えます。
kubeconfigを使用して Kubernetesにアクセスする方法についてさらに詳しく知りたい場合は、公式ドキュメントをご参照ください。
ロール別アクセス範囲
kubeconfigで実行できるタスクは、Projectメンバーのロールによって異なります。ロールが変更されると、新しい kubeconfigを受け取らなくても即座に反映されます。
| ロール | 実行可能なタスク |
|---|---|
| Admin | Writerのすべてのタスクと API Key管理 |
| Writer | Project Namespace内のワークロード(Pod、Job、PyTorchJob、Notebook、InferenceServiceなど)および ConfigMap、Secret、PVCの作成・変更・削除 |
| Reader | Project Namespace内のリソースの照会 |
権限エラーが発生した場合は、Membersでロールを確認するか、Project Adminにお問い合わせください。