mtls CLI 命令参考
mtls CLI 命令的详细信息
描述
检查 mTLS 是否已启用。
支持的平台
用法
dapr mtls [flags]
dapr mtls [command]
标志
| 名称 | 环境变量 | 默认值 | 描述 |
|---|
--help, -h | | | 打印此帮助消息 |
--kubernetes, -k | | false | 检查 Kubernetes 集群中是否启用了 mTLS |
可用命令
expiry 检查根证书颁发机构（CA）证书的过期时间
export 将根证书颁发机构（CA）、颁发者证书和颁发者密钥导出到本地文件
renew-certificate 轮换现有的根证书颁发机构（CA）、颁发者证书和颁发者密钥
命令参考
你可以通过以下链接了解每个子命令的更多信息。
示例
# 检查 Kubernetes 集群上的 mTLS 是否已启用
dapr mtls -k
警告消息
此命令可能会发出警告消息。
根证书续期警告
如果部署到 Kubernetes 集群的 mtls 根证书将在 30 天内过期，将显示以下警告消息：
Dapr root certificate of your Kubernetes cluster expires in <n> days. Expiry date: <date:time> UTC.
Please see docs.dapr.io for certificate renewal instructions to avoid service interruptions.
1 - mtls export CLI 命令参考
mtls export CLI 命令的详细信息
说明
将根证书颁发机构(CA)、颁发者证书和颁发者密钥导出到本地文件
支持的平台
用法
标志
| 名称 | 环境变量 | 默认值 | 说明 |
|---|
--help, -h | | | export 的帮助信息 |
--out, -o | | 当前目录 | 用于保存证书的输出目录路径 |
示例
# 导出 Kubernetes 证书到指定目录
dapr mtls export -o ./certs
警告消息
此命令可能会发出警告消息。
根证书续期警告
如果部署到 Kubernetes 集群的 mtls 根证书将在 30 天内过期，将显示以下警告消息：
Dapr root certificate of your Kubernetes cluster expires in <n> days. Expiry date: <date:time> UTC.
Please see docs.dapr.io for certificate renewal instructions to avoid service interruptions.
2 - mtls expiry CLI 命令参考
mtls expiry CLI 命令的详细信息
描述
检查根证书颁发机构 (CA) 证书的到期时间
支持的平台
用法
标志
| 名称 | 环境变量 | 默认值 | 描述 |
|---|
--help, -h | | | 帮助信息 |
示例
# 检查 Kubernetes 证书的到期时间
dapr mtls expiry
3 - mtls renew certificate CLI 命令参考
mtls renew certificate CLI 命令的详细信息
描述
此命令可用于续订即将过期的 Dapr 证书。例如，Dapr Sentry 服务可以生成应用程序使用的默认根证书和颁发者证书。有关更多信息，请参阅安全的 Dapr 与 Dapr 通信
支持的平台
用法
dapr mtls renew-certificate [flags]
标志
| 名称 | 环境变量 | 默认值 | 描述 |
|---|
--help, -h | | | 显示 renew-certificate 的帮助信息 |
--kubernetes, -k | | false | 支持的平台 |
--valid-until | | 365 天 | 新创建证书的有效期 |
--restart | | false | 重启 Dapr 控制平面服务（Sentry 服务、Operator 服务和 Placement 服务器） |
--timeout | | 300 秒 | 证书续订过程的超时时间 |
--ca-root-certificate | | | 用户提供的 PEM 根证书的文件路径 |
--issuer-public-certificate | | | 用户提供的 PEM 颁发者证书的文件路径 |
--issuer-private-key | | | 用户提供的 PEM 颁发者私钥的文件路径 |
--private-key | | | 用户提供的 root.key 文件，用于生成根证书 |
示例
通过生成全新的证书来续订证书
为 Kubernetes 集群生成新的根证书和颁发者证书，默认有效期为 365 天。证书不会应用到 Dapr 控制平面。
dapr mtls renew-certificate -k
为 Kubernetes 集群生成新的根证书和颁发者证书，默认有效期为 365 天，并重启 Dapr 控制平面服务。
dapr mtls renew-certificate -k --restart
为 Kubernetes 集群生成新的根证书和颁发者证书，具有给定的有效期。
dapr mtls renew-certificate -k --valid-until <天数>
为 Kubernetes 集群生成新的根证书和颁发者证书，具有给定的有效期并重启 Dapr 控制平面服务。
dapr mtls renew-certificate -k --valid-until <天数> --restart
使用用户提供的证书来续订证书
使用提供的 ca.pem、issuer.pem 和 issuer.key 文件路径为 Kubernetes 集群轮换证书并重启 Dapr 控制平面服务
dapr mtls renew-certificate -k --ca-root-certificate <ca.pem> --issuer-private-key <issuer.key> --issuer-public-certificate <issuer.pem> --restart
使用提供的 ca.pem、issuer.pem 和 issuer.key 文件路径为 Kubernetes 集群轮换证书。
dapr mtls renew-certificate -k --ca-root-certificate <ca.pem> --issuer-private-key <issuer.key> --issuer-public-certificate <issuer.pem>
使用提供的根私钥通过生成全新的证书来续订证书
使用现有的 root.key 私钥为 Kubernetes 集群生成新的根证书和颁发者证书，创建的证书具有给定的有效期。
dapr mtls renew-certificate -k --private-key myprivatekey.key --valid-until <天数>
使用现有的 root.key 私钥为 Kubernetes 集群生成新的根证书和颁发者证书。
dapr mtls renew-certificate -k --private-key myprivatekey.key