在开始之前
你必须拥有一个Kubernetes的集群,同时你的Kubernetes集群必须带有kubectl命令行工具。建议在至少有两个节点的集群上运行本教程,且这些节点不作为控制平面主机。如果你还没有集群,你可以通过Minikube构建一个你自己的集群,或者你可以使用下面任意一个Kubernetes工具构建:
创建配置文件
你可以先用JSON或YAML格式在文件中创建Secret,然后创建该对象。Secret资源包含2个键值对:data和stringData。data字段用来存储base64编码的任意数据。提供stringData字段是为了方便,它允许Secret使用未编码的字符串。data和stringData的键必须由字母、数字、-,_或.组成。
例如,要使用Secret的data字段存储两个字符串,请将字符串转换为base64,如下所示:
echo -n 'admin' | base64
输出类似于:
YWRtaW4=
echo -n '1f2d1e2e67df' | base64
输出类似于:
MWYyZDFlMmU2N2Rm
编写一个Secret配置文件,如下所示:
apiVersion: v1
kind: Secret
metadata:
name: mysecret
type: Opaque
data:
username: YWRtaW4=
password: MWYyZDFlMmU2N2Rm
注意,Secret对象的名称必须是有效的DNS子域名.
说明:
Secret数据的JSON和YAML序列化结果是以base64编码的。换行符在这些字符串中无效,必须省略。在Darwin/macOS上使用
base64工具时,用户不应该使用
-b选项分割长行。相反地,Linux用户应该在
base64的命令中添加
-w0选项,或者在
-w选项不可用的情况下,输入
base64|tr-d'\n'。
对于某些场景,你可能希望使用stringData字段。这字段可以将一个非base64编码的字符串直接放入Secret中,当创建或更新该Secret时,此字段将被编码。
上述用例的实际场景可能是这样:当你部署应用时,使用Secret存储配置文件,你希望在部署过程中,填入部分内容到该配置文件。
例如,如果你的应用程序使用以下配置文件:
apiUrl: "https://my.api.com/api/v1"
username: ""
password: ""
你可以使用以下定义将其存储在Secret中:
apiVersion: v1
kind: Secret
metadata:
name: mysecret
type: Opaque
stringData:
config.yaml: |
apiUrl: "https://my.api.com/api/v1"
username:
password:
创建Secret对象
现在使用kubectlapply创建Secret:
kubectl apply -f ./secret.yaml
输出类似于:
secret/mysecret created
检查Secret
stringData字段是只写的。获取Secret时,此字段永远不会输出。例如,如果你运行以下命令:
kubectl get secret mysecret -o yaml
输出类似于:
apiVersion: v1
data:
config.yaml: YXBpVXJsOiAiaHR0cHM6Ly9teS5hcGkuY29tL2FwaS92MSIKdXNlcm5hbWU6IHt7dXNlcm5hbWV9fQpwYXNzd29yZDoge3twYXNzd29yZH19
kind: Secret
metadata:
creationTimestamp: 2018-11-15T20:40:59Z
name: mysecret
namespace: default
resourceVersion: "7225"
uid: c280ad2e-e916-11e8-98f2-025000000001
type: Opaque
命令kubectlget和kubectldescribe默认不显示Secret的内容。这是为了防止Secret意外地暴露给旁观者或者保存在终端日志中。
如果在data和stringData中都指定了一个字段,比如username,字段值来自stringData。例如,下面的Secret定义:
apiVersion: v1
kind: Secret
metadata:
name: mysecret
type: Opaque
data:
username: YWRtaW4=
stringData:
username: administrator
结果有以下Secret:
apiVersion: v1
data:
username: YWRtaW5pc3RyYXRvcg==
kind: Secret
metadata:
creationTimestamp: 2018-11-15T20:46:46Z
name: mysecret
namespace: default
resourceVersion: "7579"
uid: 91460ecb-e917-11e8-98f2-025000000001
type: Opaque
其中YWRtaW5pc3RyYXRvcg==解码成administrator。
清理
删除你创建的Secret:
kubectl delete secret mysecret