本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

建立和管理空間

資料科學家可以列出以檢視其可存取的所有空間、使用其中一個範本建立空間、更新空間以更新影像、檔案系統，以及空間組態的其他屬性，以及刪除空間。作為先決條件，客戶必須安裝 HyperPod CLI 或使用 kubectl 來建立和管理空間。如需 HyperPod CLI 的詳細資訊，請參閱此處。若要使用 kubectl 命令，請參閱本指南以安裝 kubectl。

建立空間

HyperPod CLI

建立 Jupyter 空間

hyp create hyp-space \ 
    --name myspace \ 
    --display-name "My Space" \ 
    --memory 8Gi \ 
    --template-ref name=sagemaker-jupyter-template,namespace=jupyter-k8s-system

建立程式碼編輯器空間

hyp create hyp-space \ 
    --name myspace \ 
    --display-name "My Space" \ 
    --memory 8Gi \ 
    --template-ref name=sagemaker-code-editor-template,namespace=jupyter-k8s-system

kubectl

kubectl apply -f - <<EOF
apiVersion: workspace.jupyter.org/v1alpha1
kind: Workspace
metadata:
  name: my-space
spec:
  displayName: my-space
  desiredStatus: Running
EOF

或者您可以直接套用 yaml 檔案

kubectl apply -f my-workspace.yaml

列出空格

HyperPod CLI

hyp list hyp-space

kubectl

kubectl get workspaces -n <workspace-namespace> 

描述空間

HyperPod CLI

hyp describe hyp-space --name myspace

kubectl

# Basic Status reporting
kubectl get workspace my-workspace -n <workspace-namespace>

# Enhanced Workspace Information Retrieval 
kubectl get workspace my-workspace -n <workspace-namespace> -o wide

# Complete Workspace Information Retrieval
kubectl get workspace my-workspace -n <workspace-namespace> -o json
kubectl get workspace my-workspace -n <workspace-namespace> -o yaml

更新空間

HyperPod CLI

hyp update hyp-space \
    --name myspace \
    --display-name "Updated My Space"

kubectl

視需要更新原始工作區 YAML 檔案，然後重新套用。請確定中繼資料名稱未修改。您也可以使用這些 kubectl 命令來修改欄位，而無需重新套用整個工作區 yaml：

# Open a Terminal IDE and modify the Workspace
kubectl edit workspace -n <workspace-namespace>

# Patch a Workspace
kubectl patch workspace <workspace-name> --type='merge' -p \
    '{"spec":{"<field name>":"<desired value>"}}' -n <workspace-namespace>

開始/停止空間

HyperPod CLI

hyp start hyp-space --name myspace
hyp stop hyp-space --name myspace

kubectl

您可以在工作區中更新所需的狀態欄位，以開始/停止空間。

# Start a Workspace
kubectl patch workspace <workspace-name> --type='merge' -p \
    '{"spec":{"desiredStatus":"Running"}}' -n <workspace-namespace>
    
# Stop a Workspace
kubectl patch workspace <workspace-name> --type='merge' -p \
    '{"spec":{"desiredStatus":"Stopped"}}' -n <workspace-namespace>

取得日誌

HyperPod CLI

hyp get-logs hyp-space --name myspace

kubectl

# Check Pod Logs
kubectl logs -l workspace.jupyter.org/workspace-name=<workspace-metadata-name>

# Check Pod Events
kubectl describe pod -l workspace.jupyter.org/workspace-name=<workspace-metadata-name>

# Check Operator Logs
kubectl logs -n jupyter-k8s-system deployment/jupyter-k8s-controller-manager

刪除空間

HyperPod CLI

hyp delete hyp-space --name myspace

kubectl

# Delete a Workspace
kubectl delete workspace <workspace-name> -n <namespace>