本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

创建和管理空间

数据科学家可以列出以查看他们有权访问的所有空间，使用其中一个模板创建空间，更新空间以更新图像、文件系统和空间配置的其他属性，以及删除空间。作为先决条件，客户必须安装 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/stop 为空间。

# 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>