设置环境

请完成以下步骤，为咱们的第一个执行环境，设置本地环境：

确保咱们系统中安装了以下软件包：

podman 或 docker
python3
python3-pip

如果咱们使用 DNF 软件包管理器，请按如下步骤安装这些先决条件：

sudo dnf install -y podman python3 python3-pip

安装 ansible-navigator：

pip3 install ansible-navigator

安装 ansible-navigator 可让咱们在命令行上运行 EE。他包括了用于构建 EE 的 ansible-builder 软件包。

如果咱们想无需测试情况下构建 EE，则只需安装 ansible-builder：

pip3 install ansible-builder

使用以下命令验证咱们的环境：

ansible-navigator --version
ansible-builder --version

准备好通过几个简单的步骤构建 EE 吗？请前往构建咱们的第一个执行环境。

想在无需构建 EE 的情况下试用 EE？请前往使用社区 EE 映像运行 Ansible。

构建咱们的首个执行环境

我们将构建一个 EE，他代表一个 Ansible 控制节点，除了 Ansible 专辑（ community.postgresql ）及其依赖包（psycopg2-binary Python 连接器）外，还包含 ansible-core 和 Python 等标准软件包。

要建立咱们的首个 EE：

在文件系统中创建一个项目文件夹；

mkdir my_first_ee && cd my_first_ee

创建 execution-environment.yml 文件，指定出要包含在镜像中的依赖项；

version: 3

images:
  base_image:
    name: quay.io/fedora/fedora:39

dependencies:
  ansible_core:
    package_pip: ansible-core
  ansible_runner:
    package_pip: ansible-runner
  system:
  - openssh-clients
  - sshpass
  - iputils
  - iproute
  galaxy:
    collections:
      - name: community.postgresql

注意：psycopg2-binary Python 软件包，包含在了该专辑的 requirements.txt 文件中。对于不包含 requirements.txt 文件的专辑，就需要明确指定出 Python 依赖关系。详情请参阅 Ansible Builder 文档。

构建出一个名为 postgresql_ee 的 EE 容器镜像。

如果使用 docker，就要添加 --container-runtime docker 参数。

ansible-builder build --tag postgresql_ee

列出容器映像，以验证是否成功构建。

> docker images
REPOSITORY                                    TAG       IMAGE ID       CREATED             SIZE
postgresql_ee                                 latest    fd6bc16db1ae   About an hour ago   258MB
...

通过检查 context 目录中的 Containerfile 或 Dockerfile 查看其配置，咱们可以验证所创建的镜像。

> less first_ee/context/Dockerfile
ARG EE_BASE_IMAGE="quay.io/fedora/fedora:39"
ARG PYCMD="/usr/bin/python3"
ARG PKGMGR_PRESERVE_CACHE=""
ARG ANSIBLE_GALAXY_CLI_COLLECTION_OPTS=""
ARG ANSIBLE_GALAXY_CLI_ROLE_OPTS=""
ARG ANSIBLE_INSTALL_REFS="ansible-core ansible-runner"
ARG PKGMGR="/usr/bin/dnf"

# Base build stage
FROM $EE_BASE_IMAGE as base
USER root
ENV PIP_BREAK_SYSTEM_PACKAGES=1
ARG EE_BASE_IMAGE
ARG PYCMD
ARG PKGMGR_PRESERVE_CACHE
ARG ANSIBLE_GALAXY_CLI_COLLECTION_OPTS
ARG ANSIBLE_GALAXY_CLI_ROLE_OPTS
ARG ANSIBLE_INSTALL_REFS
ARG PKGMGR

COPY _build/scripts/ /output/scripts/
COPY _build/scripts/entrypoint /opt/builder/bin/entrypoint
RUN /output/scripts/pip_install $PYCMD
RUN $PYCMD -m pip install --no-cache-dir $ANSIBLE_INSTALL_REFS

# Galaxy build stage
FROM base as galaxy
ARG EE_BASE_IMAGE
ARG PYCMD
ARG PKGMGR_PRESERVE_CACHE
ARG ANSIBLE_GALAXY_CLI_COLLECTION_OPTS
ARG ANSIBLE_GALAXY_CLI_ROLE_OPTS
ARG ANSIBLE_INSTALL_REFS
ARG PKGMGR

RUN /output/scripts/check_galaxy
COPY _build /build
WORKDIR /build

RUN mkdir -p /usr/share/ansible
RUN ansible-galaxy role install $ANSIBLE_GALAXY_CLI_ROLE_OPTS -r requirements.yml --roles-path "/usr/share/ansible/roles"
RUN ANSIBLE_GALAXY_DISABLE_GPG_VERIFY=1 ansible-galaxy collection install $ANSIBLE_GALAXY_CLI_COLLECTION_OPTS -r requirements.yml --collections-path "/usr/share/ansible/collections"

# Builder build stage
FROM base as builder
ENV PIP_BREAK_SYSTEM_PACKAGES=1
WORKDIR /build
ARG EE_BASE_IMAGE
ARG PYCMD
ARG PKGMGR_PRESERVE_CACHE
ARG ANSIBLE_GALAXY_CLI_COLLECTION_OPTS
ARG ANSIBLE_GALAXY_CLI_ROLE_OPTS
ARG ANSIBLE_INSTALL_REFS
ARG PKGMGR

RUN $PYCMD -m pip install --no-cache-dir bindep pyyaml packaging

COPY --from=galaxy /usr/share/ansible /usr/share/ansible

COPY _build/bindep.txt bindep.txt
RUN $PYCMD /output/scripts/introspect.py introspect --user-bindep=bindep.txt --write-bindep=/tmp/src/bindep.txt --write-pip=/tmp/src/requirements.txt
RUN /output/scripts/assemble

# Final build stage
FROM base as final
ENV PIP_BREAK_SYSTEM_PACKAGES=1
ARG EE_BASE_IMAGE
ARG PYCMD
ARG PKGMGR_PRESERVE_CACHE
ARG ANSIBLE_GALAXY_CLI_COLLECTION_OPTS
ARG ANSIBLE_GALAXY_CLI_ROLE_OPTS
ARG ANSIBLE_INSTALL_REFS
ARG PKGMGR

RUN /output/scripts/check_ansible $PYCMD

COPY --from=galaxy /usr/share/ansible /usr/share/ansible

COPY --from=builder /output/ /output/
RUN /output/scripts/install-from-bindep && rm -rf /output/wheels
RUN chmod ug+rw /etc/passwd
RUN mkdir -p /runner && chgrp 0 /runner && chmod -R ug+rwx /runner
WORKDIR /runner
RUN $PYCMD -m pip install --no-cache-dir 'dumb-init==1.2.5'
RUN rm -rf /output
LABEL ansible-execution-environment=true
USER 1000
ENTRYPOINT ["/opt/builder/bin/entrypoint", "dumb-init"]
CMD ["bash"]

咱们还可以使用 Ansible Navigator，查看镜像的详细信息。

请运行 ansible-navigator 命令，在 TUI 中输入 :images，然后选择 postgresql_ee。

（End）

又一本 Ansible 教程

设置环境

构建咱们的首个执行环境