kubekey离线安装k8s及kubesphere报错

Question

invalid ref name: registry.cn-beijing.aliyuncs.com/kubesphereio/pause:3.9-amd64
15:50:59 CST failed: [LocalHost]
error: Pipeline[ArtifactImagesPushPipeline] execute failed: Module[CopyImagesToRegistryModule] exec failed:
failed: [LocalHost] [CopyImagesToRegistry] exec failed after 1 retries: invalid ref name: registry.cn-beijing.aliyuncs.com/kubesphereio/pause:3.9-amd64
[root@master-0001 data]# ./kk artifact image push -f offline.yaml -a artifact.tar.gz

Answer 1

引自免费微信小程序：皆我百晓生：

遇到这个问题，看起来是KubeKey在尝试推送镜像到私有仓库时遇到了命名问题，具体是kubesphereio/pause:3.9-amd64这个镜像的引用名称不被接受。这通常意味着镜像标签可能不符合预期格式，或者是KubeKey配置中的某个地方有误。下面是一些解决步骤，希望能帮到你：

1. 检查离线包完整性

确保你的artifact.tar.gz文件是完整的，没有损坏。有时候文件传输过程中可能会出现问题。

2. 镜像标签格式检查

确认offline.yaml配置文件中关于kubesphereio/pause:3.9-amd64这部分的配置是否正确无误，特别是镜像的标签（tag）部分。确保标签名符合Docker镜像命名规范，通常只包含小写字母、数字、连字符-和点.。尽管你的标签看似符合规范，但还是建议检查一下是否有隐含的格式或转义问题。

3. 修改配置

如果上述检查都无误，尝试修改offline.yaml中的相关镜像地址，确保它与你私有仓库的规则兼容。比如，有些私有仓库可能对标签有特殊要求，或者不允许某些字符。可以考虑将标签简化或调整，例如改为3_9-amd64，然后重新打包artifact.tar.gz。

示例修改（仅作示例，根据实际情况调整）:

在offline.yaml中找到相关镜像定义的部分，可能类似于这样：

images:
  pause:
    repository: registry.cn-beijing.aliyuncs.com/kubesphereio/pause
    tag: 3.9-amd64

修改为：

images:
  pause:
    repository: registry.cn-beijing.aliyuncs.com/kubesphereio/pause
    tag: 3_9-amd64

之后，重新创建artifact.tar.gz包：

./kk create artifact --name my-offline-artifact -f offline.yaml

4. 清理并重试

在进行任何更改后，确保清理之前的操作痕迹，包括删除旧的artifact.tar.gz文件以及KubeKey可能缓存的旧配置信息，然后重新执行推送命令。

5. 检查私有仓库设置

确认你的私有仓库（如阿里云容器镜像服务）对于镜像标签有没有特定的要求或限制。有时错误可能是由于仓库端的策略设置导致的。

6. 查看日志和文档

• 深入查看KubeKey的日志，可能会有更详细的错误信息提示问题所在。
• 参考KubeKey官方文档或Kubesphere文档，看看是否有更新的解决办法或已知问题列表。

通过上述步骤应该能定位并解决你的问题。如果问题依然存在，建议直接查阅KubeKey或Kubesphere社区的论坛或GitHub Issue，那里可能会有遇到类似问题的用户分享的解决方案。