跳到内容

Ansible Navigator 文档

安装

安装支持执行环境的 ansible-navigator¶

Linux
macOS
带 WSL2 的 Windows

建议

安装 ansible-navigator 的推荐方法是使用 ansible-dev-tools 包。Ansible 开发工具旨在简化创建 Ansible 内容所需的多种工具的设置和使用。它将关键的 Ansible 开发包组合到一个统一的 Python 包中。

# This also installs ansible-core if it is not already installed
pip3 install ansible-dev-tools

Linux¶

要求¶

podman 或适用于 Linux 的 Docker
互联网访问（在初始安装期间）

安装用于执行环境支持的所需容器引擎¶

按照适用于相应发行版的 podman 安装说明进行操作。
按照适用于相应发行版的适用于 Linux 的 Docker 安装说明进行操作。

安装 ansible-navigator¶

使用系统包安装程序安装 python 包管理器 (例如)
```
sudo dnf install python3-pip
```

安装 ansible-navigator

python3 -m pip install ansible-navigator --user

将安装路径添加到用户 shell 初始化文件 (例如)
```
echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.profile
```
刷新 PATH (例如)
```
source ~/.profile
```
启动 ansible-navigator
```
ansible-navigator
```
ansible-navigator 触发一次性下载演示执行环境镜像的操作。

macOS¶

要求 (macos)¶

适用于 Mac 的 Docker Desktop 或 macOS 上的 Podman
macOS 命令行开发人员工具
互联网访问（在初始安装期间）

安装用于执行环境支持的所需容器引擎 (macos)¶

适用于 Mac 的 Docker Desktop 安装说明
MacOS 上的 Podman 安装说明

安装 ansible-navigator (macos)¶

安装命令行开发人员工具，并在提示时继续安装。
```
xcode-select --install
```
安装 ansible-navigator
```
pip3 install ansible-navigator --user
```

使用已安装的 Python 版本将安装路径添加到 PATH

echo 'export PATH=$HOME/Library/Python/3.10/bin:$PATH' >> ~/.zprofile

刷新 PATH
```
source ~/.zprofile
```
启动 ansible-navigator
```
ansible-navigator
```
ansible-navigator 触发一次性下载演示执行环境镜像的操作。

带 WSL2 的 Windows¶

要求 (windows)¶

使用 Ubuntu 设置 Windows Linux 子系统 2¶

安装适用于 Linux 2 的 Windows 子系统。
从 Microsoft 商店安装 Ubuntu 20.04 LTS Linux 发行版。
打开 PowerShell 并设置默认的 WSL 2 发行版
```
wsl --set-default ubuntu
```
从 Windows 菜单启动 Ubuntu] 虚拟机并完成初始设置。
在 Ubuntu 终端中，创建 /dev/mqueue 目录
```
sudo mkdir /dev/mqueue
```

安装用于执行环境支持的所需容器引擎 (windows)¶

在 Ubuntu 20.04 LTS 上安装 podman 的说明。

!!! 注意

  The podman package is available in the official repositories for Ubuntu 20.10 and newer.
  Since interim releases of Ubuntu are not available on the Microsoft Store for WSL the
  [Kubic project] package can be used.

更新 ubuntu 包索引
```
sudo apt update
```
安装 podman 的系统依赖项
```
apt-get install curl wget gnupg2
```
获取 Ubuntu 版本信息
```
source /etc/os-release
```

添加 podman 存储库

sudo sh -c "echo 'deb http://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/xUbuntu_${VERSION_ID}/ /' > /etc/apt/sources.list.d/devel:kubic:libcontainers:stable.list"

下载 GPG 密钥

wget -nv https://download.opensuse.org/repositories/devel:kubic:libcontainers:stable/xUbuntu_${VERSION_ID}/Release.key -O- | sudo apt-key add -

使用新存储库更新
```
sudo apt-get update
```
安装 podman
```
sudo apt-get install podman
```
按照适用于 Windows 的 Docker Desktop 安装说明进行操作（如果未安装上述 podman）
请务必完成以非 root 用户身份管理 Docker 步骤。

安装 ansible-navigator (windows)¶

从 Ubuntu 终端

确保 /dev/mqueue 目录存在
```
sudo mkdir /dev/mqueue
```
安装 python 包管理器
```
sudo apt install python3-pip
```

安装 ansible-navigator

python3 -m pip install ansible-navigator --user

将安装路径添加到用户 shell 初始化文件

echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.profile

刷新 PATH
```
source ~/.profile
```
启动 ansible-navigator
```
ansible-navigator
```
ansible-navigator 触发一次性下载演示执行环境镜像的操作。