Running your EE
You can run your EE on the command line against localhost or a remote target using ansible-navigator.
Note
There are other tools besides ansible-navigator you can run EEs with.
Run against localhost
-
Create a
test_localhost.ymlplaybook.- name: Gather and print local facts hosts: localhost gather_facts: true tasks: - name: Print facts ansible.builtin.debug: var: ansible_facts -
Run the playbook inside the
postgresql_eeEE.ansible-navigator run test_localhost.yml --execution-environment-image postgresql_ee --mode stdout --pull-policy missing
You may notice the facts being gathered are about the container and not the developer machine. This is because the ansible playbook was run inside the container.
Run against a remote target
Before you start, ensure you have the following:
- At least one IP address or resolvable hostname for a remote target.
- Valid credentials for the remote host.
- A user with
sudopermissions on the remote host.
Execute a playbook inside the postgresql_ee EE against a remote host machine as in the following example:
-
Create a directory for inventory files.
mkdir inventory
-
Create the
hosts.ymlinventory file in theinventorydirectory.all: hosts: 192.168.0.2 # Replace with the IP of your target host -
Create a
test_remote.ymlplaybook.- name: Gather and print facts hosts: all become: true gather_facts: true tasks: - name: Print facts ansible.builtin.debug: var: ansible_facts -
Run the playbook inside the
postgresql_eeEE.Replace
studentwith the appropriate username. Some arguments in the command can be optional depending on your target host authentication method.ansible-navigator run test_remote.yml -i inventory --execution-environment-image postgresql_ee:latest --mode stdout --pull-policy missing --enable-prompts -u student -k -K
See also
- Execution Environment Definition
-
Provides information about the about Execution Environment definition file and available options.
- Ansible Builder CLI usage
-
Provides details about using Ansible Builder.
- Ansible Navigator documentation
-
Provides details about using Ansible Navigator.
- Running a local container registry for EEs
-
This guide in the Ansible community forum explains how to set up a local registry for your Execution Environment images.
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/getting_started_ee/run_execution_environment.html