Flux2项目解决Azure DevOps SSH-RSA密钥废弃问题的技术方案

背景介绍

随着微软Azure DevOps服务宣布逐步废弃SSH-RSA密钥算法，许多使用Flux2进行GitOps部署的用户遇到了源同步失败的问题。错误信息显示"SSH-RSA is about to be deprecated"，导致在Azure DevOps的"brown out"期间（随机时间段内的服务中断）无法正常进行代码拉取操作。

问题本质

Azure DevOps正在强制迁移到更安全的密钥算法（rsa-sha2-256或rsa-sha2-512），而Flux2默认配置可能仍在使用将被废弃的SSH-RSA算法。这会导致在服务中断期间出现认证失败。

解决方案

方案一：迁移到RSA SHA-2算法

1. 生成新的SSH密钥对

使用以下命令生成新的RSA SHA-2 512位密钥对：

ssh-keygen -t rsa-sha2-512

2. 配置Azure DevOps

将生成的公钥上传到Azure DevOps的SSH公钥设置中。

3. 更新Flux2密钥

删除现有的flux-system密钥并创建新的：

kubectl -n flux-system delete secret flux-system

flux -n flux-system create secret git flux-system \
--url=sssh://[e-mail]/v3/<组织>/<项目>/<仓库> \
--private-key-file=<私钥路径> \
--password=<密钥密码>

4. 配置主机密钥算法

在flux-system的kustomization.yaml中添加补丁：

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - gotk-components.yaml
  - gotk-sync.yaml
patches:
  - patch: |
      - op: add
        path: /spec/template/spec/containers/0/args/-
        value: --ssh-hostkey-algos=rsa-sha2-512,rsa-sha2-256      
    target:
      kind: Deployment
      name: (source-controller|image-automation-controller)

5. 强制应用变更

如果Flux当前无法从Azure DevOps拉取变更，可直接应用清单：

kubectl apply -k clusters/<集群名>/flux-system

方案二：迁移到HTTPS协议

如果不想处理SSH密钥问题，可以改用HTTPS协议：

1. 在Azure门户生成个人访问令牌(PAT)
2. 删除现有的flux-system密钥
3. 使用PAT重新引导Flux：

echo <DEVOPS-PAT> | flux bootstrap git \
  --token-auth=true \
  --url=https://dev.azure.com/<组织>/<项目>/_git/<仓库> \
  --branch=main \
  --path=clusters/<集群名>

技术细节说明

1. 虽然Azure DevOps主机密钥显示为"ssh-rsa"，但实际上服务器支持三种算法：ssh-rsa、rsa-sha2-256和rsa-sha2-512。

2. 必须同时为source-controller和image-automation-controller配置主机密钥算法，否则自动化镜像更新可能会失败。

3. 对于使用Terraform管理Flux的用户，未来版本将提供更直接的配置方式：

provider "flux" {
        ssh = {
          hostkey_algos = ["rsa-sha2-512", "rsa-sha2-256"]
        }
}

验证与测试

由于Azure DevOps采用"brown out"机制（随机时间段的服务中断），验证解决方案是否有效需要等待服务中断期间观察系统行为。这给测试带来了一定难度。

最佳实践建议

1. 对于新部署的Flux2集群，建议直接使用RSA SHA-2 512位密钥方案。

2. 对于现有集群，建议在非生产环境先验证迁移方案，确认无误后再在生产环境实施。

3. 考虑将SSH协议迁移到HTTPS协议可以彻底避免此类密钥算法兼容性问题。

4. 保持Flux2组件更新到最新版本，以获得最佳兼容性和安全性。

通过以上方案，用户可以顺利解决Azure DevOps SSH-RSA废弃带来的问题，确保GitOps流程的持续稳定运行。