mirror of
https://github.com/ruanbekker/rpi-ansible.git
synced 2025-04-20 09:11:45 +02:00
fix readme, requirements
This commit is contained in:
parent
55ce68b3fe
commit
01856825a8
24
README.md
24
README.md
@ -1,12 +1,17 @@
|
|||||||
# Raspberry Pi Ansible
|
# Raspberry Pi Ansible Playbook
|
||||||
|
|
||||||
Glenn K. Lockwood, October 2018
|
Glenn K. Lockwood, October 2018 - July 2020.
|
||||||
|
|
||||||
## Introduction
|
## Introduction
|
||||||
|
|
||||||
This is an Ansible configuration that configures a fresh Raspbian installation
|
This is an Ansible configuration that configures a fresh Raspbian installation
|
||||||
on Raspberry Pi. It is intended to be run in local (pull) mode, where ansible
|
on Raspberry Pi. It can be run in local (pull) mode, where ansible is running
|
||||||
is running on the same Raspberry Pi to be configured.
|
on the same Raspberry Pi to be configured, or standard remote mode.
|
||||||
|
|
||||||
|
This playbook is known to run on Raspbian stretch (9) and Raspberry Pi OS
|
||||||
|
buster (10). I've not been able to run it on jessie because that ships with
|
||||||
|
Python 2.4, which is not supported by Ansible. It can run against jessie in
|
||||||
|
remote mode. See below.
|
||||||
|
|
||||||
## Bootstrapping on Raspbian
|
## Bootstrapping on Raspbian
|
||||||
|
|
||||||
@ -16,6 +21,12 @@ playbook relies on Ansible 2.8 or newer, which means you can no longer use
|
|||||||
|
|
||||||
$ python3 -m venv --system-site-packages ansible_env
|
$ python3 -m venv --system-site-packages ansible_env
|
||||||
|
|
||||||
|
If this fails, you may need to:
|
||||||
|
|
||||||
|
$ sudo apt install python3-apt python3-virtualenv
|
||||||
|
|
||||||
|
Then activate the environment and install ansible:
|
||||||
|
|
||||||
$ source ./ansible_env/bin/activate
|
$ source ./ansible_env/bin/activate
|
||||||
|
|
||||||
# Make sure that pip will install into our virtualenv
|
# Make sure that pip will install into our virtualenv
|
||||||
@ -38,7 +49,8 @@ This playbook can be run on localhost or against one or more remote hosts. The
|
|||||||
former is good for a bare Raspberry Pi that was freshly provisioned using NOOBS
|
former is good for a bare Raspberry Pi that was freshly provisioned using NOOBS
|
||||||
or the like, as you don't need a second host to act as the provisioning host.
|
or the like, as you don't need a second host to act as the provisioning host.
|
||||||
The latter is the conventional way in which ansible is typically run and makes
|
The latter is the conventional way in which ansible is typically run and makes
|
||||||
more sense if you want to configure a bunch of Raspberry Pis.
|
more sense if you want to configure a bunch of Raspberry Pis. Depending on
|
||||||
|
the mode you intend to use, the configuration is slightly different.
|
||||||
|
|
||||||
### Local Mode
|
### Local Mode
|
||||||
|
|
||||||
@ -72,7 +84,7 @@ Raspberry Pi.
|
|||||||
|
|
||||||
This is similar to local mode:
|
This is similar to local mode:
|
||||||
|
|
||||||
(ansible_env) $ ansible-playbook --ask-vault-pass --inventory hosts.remote ./remote.yml
|
(ansible_env) $ ansible-playbook --ask-vault-pass --ask-become-pass --inventory hosts.remote ./remote.yml
|
||||||
|
|
||||||
The playbook follows the same code path.
|
The playbook follows the same code path.
|
||||||
|
|
||||||
|
@ -1,2 +1 @@
|
|||||||
python-apt
|
|
||||||
ansible>=2.8
|
ansible>=2.8
|
||||||
|
Loading…
x
Reference in New Issue
Block a user