Skip to content

Commit

Permalink
README updates
Browse files Browse the repository at this point in the history
  • Loading branch information
nickrusso42518 committed Dec 4, 2018
1 parent 2928f02 commit 68efb6c
Showing 1 changed file with 66 additions and 1 deletion.
67 changes: 66 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,69 @@ https://travis-ci.org/nickrusso42518/slt-netdevops.svg?branch=master)](
https://travis-ci.org/nickrusso42518/slt-netdevops)

# Safari Live Training - Network DevOps
Actively in development ... check back soon!
Source code for the training course. Please contact me with any questions.
Before beginning, be sure you know how to use `git` at a basic level on
your computer. I teach `git` in the course so if you don't know how
to clone this repository yet, do not worry. For this course, only
Linux platforms should be used for the Ansible control/development machine.

> Contact information:\
> Email: njrusmc@gmail.com\
> Twitter: @nickrusso42518
* [Download Instructions](#download-instructions)
* [Usage](#usage)

## Download Instructions
The easiest way to consume this code is to clone it using SSH or HTTPS.

SSH: `git clone git@github.com:nickrusso42518/slt-netdevops`

or

HTTPS: `git clone https://github.com/nickrusso42518/slt-netdevops`

After cloning, you should see the following file system structure:

```
$ tree
.
├── ansible.cfg
├── hosts.yml
├── LICENSE
├── ntp_config.yml
├── README.md
├── requirements.txt
└── test.yml
```

Ensure you have Python 2.7 (not Python 3) installed along with pip.

> Visit https://www.python.org/downloads/ to download Python.
`sudo python -m ensurepip`

or

`sudo easy_install pip`

You can install the specific packages (really just Ansible and a YAML linter)
using the following command:

`pip install -r requirements.txt`

You should have access to the `ansible` command on the correct version.

```
$ ansible --version
ansible 2.6.2
```

## Usage
This repository is kept minimal since the main point of this course is
teaching the fundamentals of Network DevOps, not Ansible as a specific tool.
* To edit NTP server variables, open `hosts.yml` and update the
`ntp_server` variables using valid IPv4 addresses.
* To run the playbook, run `ansible-playbook ntp_config.yml` from the shell.
* To test the playbook, run `ansible-playbook test.yml` from the shell. This
mimics whta Travis CI does each time code is committed to Github.

0 comments on commit 68efb6c

Please sign in to comment.