Requirements

To install and use Ansible development tools, you must meet the following requirements. Extra requirements for Windows installations and containerized installations are indicated in the procedures.

  • Python 3.10 or later.
  • VS Code (Visual Studio Code) with the Ansible extension added.
  • For containerized installations, the Microsoft Dev Containers VS Code extension.
  • A containerization platform, for example Podman, Podman Desktop, Docker, or Docker Desktop.
    Note:

    The installation procedure for Ansible development tools on Windows covers the use of Podman Desktop only.

  • You have a Red Hat account and you can log in to the Red Hat container registry at registry.redhat.io.

Authenticate with the Red Hat container registry

All container images available through the Red Hat container catalog are hosted on an image registry, registry.redhat.io. The registry requires authentication for access to images.

Before you begin

  • You have a Red Hat login. It is the same account that you use to log in to the Red Hat Customer Portal (access.redhat.com) and manage your Red Hat subscriptions.

About this task

Note:

If you are planning to install the Ansible development tools on a container inside VS Code, you must log in to registry.redhat.io before launching VS Code so that VS Code can pull the devtools container from registry.redhat.io.

If you are running Ansible development tools on a container inside VS Code and you want to pull execution environments or the devcontainer to use as an execution environment, you must log in from a terminal prompt within the devcontainer from a terminal inside VS Code.

Procedure

  1. Check whether you are already logged in to the registry.redhat.io registry: 
    $ podman login --get-login registry.redhat.io

    The command output displays your Red Hat login if you are logged in to registry.redhat.io.

  2. If you are not logged in to registry.redhat.io, use the podman login command with your credentials to access content on the registry. 
    $ podman login registry.redhat.io
Username: my_redhat_username
Password: ***********