GitLab CI/CD配置文件无法找到Ansible命令的问题求助

问题原因 #

GitLab CI的每个Job都是独立运行的Docker容器，install-ansible阶段安装的Ansible仅存在于该阶段的容器中，到deploy-job阶段时会启动全新的容器，自然找不到已安装的命令。

解决方案 #

方案1：合并安装与部署到同一个Job #

将安装和部署步骤放在同一个Job里，确保在同一个容器环境中执行：

stages:
  - deploy

deploy-job:
  stage: deploy
  script:
    - apk add ansible -v
    - ansible-playbook ansible_roles.yml

方案2：使用预安装Ansible的自定义镜像 #

基于Alpine构建包含Ansible的镜像，推送到GitLab容器仓库或Docker Hub后，在CI配置中直接使用该镜像，省去每次安装的步骤：

1. 编写Dockerfile：

FROM alpine:latest
RUN apk add --no-cache ansible

2. 构建推送镜像后，修改.gitlab-ci.yml：

stages:
  - deploy

deploy-job:
  stage: deploy
  image: your-custom-alpine-ansible-image:latest
  script:
    - ansible-playbook ansible_roles.yml

方案3：使用缓存（不推荐） #

尝试缓存apk安装的相关文件，但该方法可靠性较低，容易出现环境不一致问题：

stages:
  - install
  - deploy

install-ansible:
  stage: install
  script:
    - apk add ansible -v
  cache:
    paths:
      - /usr/bin/ansible*
      - /usr/lib/python3.*/site-packages/ansible*

deploy-job:
  stage: deploy
  cache:
    paths:
      - /usr/bin/ansible*
      - /usr/lib/python3.*/site-packages/ansible*
  script:
    - ansible-playbook ansible_roles.yml

内容的提问来源于stack exchange，提问作者ricsi114