Skip to content

Latest commit

 

History

History
66 lines (40 loc) · 3.06 KB

MANUAL_SETUP.md

File metadata and controls

66 lines (40 loc) · 3.06 KB
Raw

Local Development Environment (Manual Setup)

If you do not wish to run the local_development.yml playbook to set up your local development environment, the steps below can guide you through the manual process of getting set to run ansible-navigator without a cldr-runner execution environment.

Install an Execution Environment

ansible-navigator typically runs within an execution environment -- an ansible-runner-enabled container. To this end, you will need to have docker or an equivalent or podman running on your host.

Docker

  • Windows
  • Mac
  • Linux users, use your package manager

Warning

Be sure you uninstall any earlier versions of Docker, i.e. docker, and install the latest version, i.e. docker-ce. See Install Docker Engine for further details.

Note

If you have not used Docker before, consider following their quick Tutorial to validate it is working and familiarize yourself with the interface.

Install Git

Note

Git is required if you intend to clone the software for local editing. If you just intend to run the automation tools, you may skip this step.

There are excellent instructions for installing Git on all Operating Systems on the Git website.

Install AWS CLI

If you are going to be working with AWS, you will want the latest version of the AWS CLI.

  • Windows
  • Mac
  • Linux users, use your package manager

If this is the first time you are installing the AWS CLI, configure the program by providing your credentials, and test that your credentials work

aws configure
aws iam get-user

Visit the AWS CLI User Guide for further details regarding credential management.

Install CDP CLI

Get the latest version of the CDP CLI.

If this is the first time you are installing the CDP CLI, you will need to configure the program by providing the right credentials, and should then test that your credentials work.

cdp configure
cdp iam get-user

Visit the CDP CLI User Guide for further details regarding credential management.

Confirm your SSH Keypair

Ensure that you have a generated SSH keypair for your local profile. Visit the SSH Keygen How-To for details.

Confirm your SSH Agent

Ensure that you have a properly configured SSH Agent. Visit the SSH Agent How-To for details.