在Alibaba Cloud Linux 2实例中使用docker-ce、epel等第三方YUM源安装软件失败

问题描述

在符合如下条件的Alibaba Cloud Linux 2实例中,使用适配CentOS 7中的docker-ce、epel第三方YUM源,执行yum install docker-ce命令安装Docker软件包失败,并提示如下报错。

  • 镜像:Alibaba Cloud Linux 2.1903 LTS 64位
  • 镜像ID:aliyun_2_1903_x64_20G_alibase_20210325.vhd及之前所有版本
Loaded plugins: fastestmirror, langpacks, update-motd
Loading mirror speeds from cached hostfile
  * epel: mirror.sjtu.edu.cn
https://mirrors.aliyun.com/docker-ce/linux/centos/2.1903/x86_64/stable/repodata/repomd.xml: [Errno 14] HTTPS Error 404 - Not Found
Trying other mirror.
Downloading packages:
docker-ce-20.10.6-3.el7.x86_64 FAILED
https://mirrors.aliyun.com/docker-ce/linux/centos/2.1903/x86_64/stable/Packages/docker-ce-20.10.6-3.el7.x86_64.rpm: [Errno 14] HTTPS Error 404 - Not Found
Trying other mirror.
docker-ce-rootless-extras-20.1 FAILED
https://mirrors.aliyun.com/docker-ce/linux/centos/2.1903/x86_64/stable/Packages/docker-ce-rootless-extras-20.10.6-3.el7.x86_64.rpm: [Errno 14] HTTPS Error 404 - Not Found
Trying other mirror.


Error downloading packages:
  3:docker-ce-20.10.6-3.el7.x86_64: [Errno 256] No more mirrors to try.
  docker-ce-rootless-extras-20.10.6-3.el7.x86_64: [Errno 256] No more mirrors to try.

问题原因

第三方YUM源仅适配CentOS 7发行版,Alibaba Cloud Linux 2操作系统与CentOS 7操作系统的releasever值不同,导致YUM解析后的地址无效,从而下载容器软件包失败。YUM安装docker-ce软件包时,首先会在系统中获取版本号,即releasever值,然后替换相应YUM源中baseurl地址对应的$releasever变量,YUM从替换后的baseurl地址中获取相关数据。由于CentOS 7操作系统的releasever值为7,Alibaba Cloud Linux 2操作系统的releasever值为2.1903,因此解析后的baseurl地址并非预期地址,YUM便无法从这个错误的地址中获取数据。

解决方案

阿里云提醒您:

  • 如果您对实例或数据有修改、变更等风险操作,务必注意实例的容灾、容错能力,确保数据安全。
  • 如果您对实例(包括但不限于ECS、RDS)等进行配置与数据修改,建议提前创建快照或开启RDS日志备份等功能。
  • 如果您在阿里云平台授权或者提交过登录账号、密码等安全信息,建议您及时修改。

下列操作以docker-ce源为例进行举例,如果您使用的是其他YUM源,解决方法类似。

临时解决方法

  1. 登录ECS实例,详情请参见连接方式概述
  2. 执行以下命令,编辑/etc/yum.repos.d/docker-ce.repo配置文件。
    vim /etc/yum.repos.d/docker-ce.repo
    1. i键切换至编辑模式,找到docker-ce.repo文件中所有enabled=1值的源,将源中baseurl地的$releasever变量修改为7,修改之后的内容如下所示。
      Dingtalk_20210610100121.jpg
    2. 修改完成后,按下Esc键后,输入:wq并回车以保存并关闭配置文件,重新安装软件包即可。

固化解决方法

安装yum-plugin-releasever-adapter插件实现releasever的自动转换,即将2.1903转换为7,yum-plugin-releasever-adapter插件目前的版本及默认支持的第三方repo如下表所示:

插件版本 默认支持的第三方repo 插件的限制
1.0-1.3 docker-ce.repo,epel.repo

您需要满足以下条件,才可以使用该插件:

  • 操作系统需要是Alibaba Cloud Linux 2。
  • 执行以下命令,确认系统中存在plus的repo。
    cat /etc/yum.repos.d/AliYun.repo |grep -A3 plus
    系统显示类似如下,说明存在plus的repo。
    Dingtalk_20210622170320.jpg
  1. 登录ECS实例,详情请参见连接方式概述
  2. 执行以下命令,安装yum-plugin-releasever-adapter插件,插件默认对docker-ce、epel第三方YUM源中的$releasever值自动进行转换。
    yum install yum-plugin-releasever-adapter --disablerepo=* --enablerepo=plus
  3. 若无其他的YUM源需要转换,安装插件后即可直接安装软件;若还有其他的YUM源需要转换,请按照以下方式配置:
    1. 执行以下命令,进入指定目录。
      cd /etc/yum/pluginconf.d/
    2. 执行以下命令,编辑releasever-adapter.conf配置文件。如果需要添加其他的YUM源,则需要将YUM源的.repo文件名添加在includes字段后面,并以逗号隔开。
      vim releasever-adapter.conf
      系统显示类似如下。
      [main]
      
      enabled=1
      hostfilepath=timedhosts.txt

      [releasevermapping]
      release_dict={'2.1903':'7', '3':'8'}

      [reposlist]
      includes=docker-ce.repo, epel.repo
      说明
      •  文件中参数的具体介绍如下所示:
        • [main]:为插件的主要控制部分,控制插件的启用与否,其中enabled=1表示启用插件,enabled=0表示停用插件。
        • [releasevermapping]:为待处理的releasever的映射关系,其中2.1903映射为7,3映射为8。
        • [repolist]:为需要修改的源的列表,如果需要添加其他的源,则需要将.repo文件的名字添加在include字段后面,并以逗号隔开。
      • 一个.repo文件中有多个可以使用的源,每个源都有一个独立的名称区分其他的源,一个系统中不能出现重复的名称,例如:docker-ce.repo中有[docker-ce-stable]和[docker-ce-stable-debuginfo]等源。
      • 请务必保证新添加到releasever-adapter.conf配置文件中的源文件名字是源文件内各个源名称的前缀,例如:docker-ce.repo源文件中包含的docker-ce-stable和docker-ce-stable-debuginfo两个源名称,均以docker-ce为前缀。
    3. 保存配置文件,执行以下命令,即可通过docker-ce、epel第三方YUM源安装软件包。
      yum install docker-ce

适用于

  • 云服务器ECS

如果您的问题仍未解决,您可以在阿里云社区免费咨询,或提交工单联系阿里云技术支持。