使用kubectl-sae工具管理命名空间Namespace

SAE的命名空间对应于Kubernetes的Namespace资源类型。本文介绍如何使用kubectl-sae工具管理SAE命名空间,并提供相关的K8s YAML配置文件示例。

前提条件

已安装kubectl-sae工具,并配置AccessKey ID、AccessKey Secret、应用部署地域,详见安装与配置kubectl-sae工具

管理命名空间

kubectl-sae工具支持创建、查看、删除命名空间,但不支持更新命名空间。

创建命名空间

  1. 编写配置文件namespace.yaml。配置文件的示例如下,各配置项的详细信息请参考K8s YAML配置项说明

    apiVersion: v1
    kind: Namespace
    metadata:
      annotations:
        sae.aliyun.com/vpc-id: vpc-xxxxxxxxxxxxxxxxxxxx # VPC ID
      name: demo # 命名空间ID
    spec: {}
  2. namespace.yaml文件所在路径执行以下命令,实现创建命名空间。

    kubectl-sae apply -f namespace.yaml

查看命名空间列表

kubectl-sae get ns

输出结果的字段说明如下:

字段

说明

NAME

命名空间ID,default 表示默认命名空间。

STATUS

命名空间的状态,Active 表示可用。

REGION

命名空间所在地域。

查看命名空间详情

kubectl-sae工具支持使用getdescribe命令查看命名空间详情。返回结果中包含命名空间的配置项,详情请参考K8s YAML配置项说明

通过get命令查看命名空间的配置信息

执行以下命令,查看指定命名空间的配置信息。

kubectl-sae get ns ${namespace} -o {yaml | json}
# ${namespace}为命名空间ID
# -o参数指定返回结果的格式

通过describe命令查看命名空间详情

执行以下命令,查看指定命名空间详情。

kubectl-sae describe ns ${namespace}
# ${namespace}为命名空间ID

删除命名空间

执行以下命令,删除指定命名空间。

kubectl-sae delete ns ${namespace}
# ${namespace}为命名空间ID

K8s YAML配置项说明

SAE的命名空间对应于Kubernetes的Namespace资源类型。相关K8s YAML配置项说明详见下表。

配置参数

说明

metadata.name

命名空间ID。

创建时必须指定此配置项。

metadata.annotations:

sae.aliyun.com/region

命名空间所在的地域。

创建时不支持此配置项。

metadata.annotations:

sae.aliyun.com/vpc-id

命名空间关联的VPC ID。

创建时必须指定此配置项。

status.phase

命名空间的状态。

创建时不支持此配置项。