tencent cloud

简介

Secret 可用于存储密码、令牌、密钥等敏感信息，降低直接对外暴露的风险。Secret 是 key-value 类型的键值对，您可以通过控制台的 Kubectl 工具创建对应的 Secret 对象，也可以通过挂载数据卷、环境变量或在容器的运行命令中使用 Secret。

Secret 控制台操作指引

创建 Secret

1. 登录容器服务控制台，选择左侧导航栏中的集群。
2. 选择需要创建 Secret 的集群 ID，进入待创建 Secret 的集群管理页面。
3. 选择左侧导航栏中的配置管理 > Secret，进入 Secret 信息页面。如下图所示：
   
4. 单击新建，进入“新建Secret”页面。
5. 在“新建Secret”页面，根据实际需求，进行如下参数设置。如下图所示：
   
   • 名称：请输入自定义名称。
   • Secret类型：提供Opaque和Dockercfg两种类型，请根据实际需求进行选择。
     • Opaque：适用于保存密钥证书和配置文件，Value 将以 base64 格式编码。
     • Dockercfg：适用于保存私有 Docker Registry 的认证信息。
   • 生效范围：提供以下两种范围，请根据实际需求进行选择。
     • 存量所有命名空间：不包括 kube-system、kube-public 和后续增量命名空间。
     • 指定命名空间：支持选择当前集群下一个或多个可用命名空间。
   • 内容：根据不同的 Secret 类型，进行配置。
     • 当 Secret 类型为Opaque时：根据实际需求，设置变量名和变量值。
     • 当 Secret 类型为Dockercfg时：

              - 仓库域名：请根据实际需求输入域名或 IP。
                  - 用户名：请根据实际需求输入第三方仓库的用户名。
                      - 密码：请根据实际需求设置第三方仓库的登录密码。

       如果本次为首次登录系统，则会新建用户，相关信息写入 ~/.dockercrg 文件中。

6. 单击创建 Secret，即可完成创建。

使用 Secret

方式一：数据卷使用 Secret 类型

1. 登录容器服务控制台，选择左侧导航栏中的集群。

2. 选择需要部署 Workload 的集群 ID，进入待部署 Workload 的集群管理页面。

3. 在工作负载下，任意选择 Workload 类型，进入对应的信息页面。
   例如，选择工作负载 >DaemonSet，进入 DaemonSet 信息页面。如下图所示：
   

4. 单击新建，进入 “新建Workload” 页面。

5. 根据页面信息，设置工作负载名、命名空间等信息。并在 “数据卷” 中，单击添加数据卷。如下图所示：
   

6. 选择使用Secret方式，填写名称，并单击选择Secret。如下图所示：
   

7. 在弹出的“设置Secret”窗口中，配置挂载点，并单击确认。如下图所示：
   

   • 选择Secret：根据实际需求进行。
   • 选项：提供全部和指定部分 Key两种选择。
   • Items：当选择指定部分 Key选项时，可以通过添加 Item 向特定路径挂载，如挂载点是 /data/config，子路径是 dev，最终会存储在 /data/config/dev 下。

8. 单击创建Workload，完成创建。

方式二：环境变量中使用 Secret 类型

1. 登录容器服务控制台，选择左侧导航栏中的集群。

2. 单击需要部署 Workload 的集群 ID，进入待部署 Workload 的集群管理页面。

3. 在工作负载下，任意选择 Workload 类型，进入对应的信息页面。
   例如，选择工作负载>DaemonSet，进入 DaemonSet 信息页面。如下图所示：
   

4. 单击新建，进入 “新建Workload” 页面。

5. 根据页面信息，设置工作负载名、命名空间等信息。并在“实例内容器”的“环境变量”中，单击引用ConfigMap/Secret。如下图所示：
   

6. 选择Secret环境变量方式，并根据实际需求选择资源。如下图所示：
   

7. 单击创建Workload，完成创建。

方法三：使用第三方镜像仓库时引用

1. 登录容器服务控制台，选择左侧导航栏中的集群。
2. 选择需要部署 Workload 的集群 ID，进入待部署 Workload 的集群管理页面。
3. 在工作负载下，任意选择 Workload 类型，进入对应的信息页面。
   例如，选择工作负载>DaemonSet，进入 DaemonSet 信息页面。如下图所示：
   
4. 单击新建，进入 “新建Workload” 页面。
5. 根据页面信息，设置工作负载名、命名空间等信息。单击本页面左下角显示高级设置 。
6. 单击添加，请根据实际情况选择dockercfg类型的Secret 。如下图所示：
   
7. 单击创建Workload，完成创建。

更新 Secret

1. 登录容器服务控制台，选择左侧导航栏中的集群。
2. 选择需要更新 YAML 的集群 ID，进入待更新 YAML 的集群管理页面。
3. 选择配置管理>Secret，进入 Secret 信息页面。如下图所示：
   
4. 在需要更新 YAML 的 Secret 行中，单击编辑YAML，进入更新 Secret 页面。
5. 在“更新Secret”页面，编辑 YAML，并单击完成即可更新 YAML。

   如需修改 key-values，则编辑 YAML 中 data 的参数值，并单击完成即可完成更新。

Kubectl 操作 Secret 指引

创建 Secret

方式一：通过指定文件创建 Secret

1. 依次执行以下命令，获取 Pod 的用户名和密码。

   $ echo -n 'username' > ./username.txt
   $ echo -n 'password' > ./password.txt
   

2. 执行 Kubectl 命令，创建 Secret。

   $ kubectl create secret generic test-secret --from-file=./username.txt --from-file=./password.txt
   secret "testSecret" created
   

3. 执行以下命令，查看 Secret 详情。

   kubectl describe secrets/ test-secret
   

方式二：YAML 文件手动创建

通过 YAML 手动创建 Secret，需提前将 Secret 的 data 进行 Base64 编码。

apiVersion: v1
kind: Secret
metadata:
name: test-secret
type: Opaque
data:
username: dXNlcm5hbWU=  ## 由echo -n 'username' | base64生成
password: cGFzc3dvcmQ=  ## 由echo -n 'password' | base64生成

使用 Secret

方式一： 数据卷使用 Secret 类型

YAML 示例如下：

apiVersion: v1
kind: Pod
metadata:
  name: nginx
spec:
  containers:
    - name: nginx
      image: nginx:latest
      volumeMounts:
       name: secret-volume
       mountPath: /etc/config
  volumes:
       name: secret-volume
       secret:
         name:  test-secret ## 设置 secret 来源
         ## items:  ## 设置指定 secret的 Key 挂载
         ##   key: username  ## 选择指定 Key
         ##   path: group/user ## 挂载到指定的子路径
         ##   mode: 256  ## 设置文件权限
  restartPolicy: Never

方式二： 环境变量中使用 Secret 类型

YAML 示例如下：

apiVersion: v1
kind: Pod
metadata:
  name: nginx
spec:
  containers:
    - name: nginx
      image: nginx:latest
      env:
        - name: SECRET_USERNAME
          valueFrom:
            secretKeyRef:
              name: test-secret ## 设置来源 Secret 文件名
              key: username  ## 设置该环境变量的 Value 来源项
  restartPolicy: Never

方法三：使用第三方镜像仓库时引用

YAML 示例如下：

apiVersion: v1
kind: Pod
metadata:
  name: nginx
spec:
  containers:
    - name: nginx
      image: nginx:latest
  imagePullSecrets:
  - name: test-secret ## 设置来源 Secret 文件名
  restartPolicy: Never