From 93ed6660054ff34f46bd39d8fccea9c2cf29df60 Mon Sep 17 00:00:00 2001 From: Anthony Perkins Date: Thu, 22 Oct 2020 10:00:33 +0100 Subject: [PATCH] Add a README.md file --- README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..d4b16b2 --- /dev/null +++ b/README.md @@ -0,0 +1,27 @@ +# Workstation Ansible playbooks + +This repository sets up various operating systems to my own preference. The +playbooks can be run against the local machine: + + ./user-cli.yml -i ./local.ini + +Or they can be run against a remote machine: + + ./user-cli.yml -i target.example.com, + +Note that the trailing comma is important when using a remote hostname. + +## Cloning without SSL verification + +Some platforms (NetBSD, FreeBSD) do not include root SSL certificates by +default. This causes the initial git clone to fail with the error +_server certificate verification failed_. You can ignore SSL warnings with the +`GIT_SSL_NO_VERIFY=true` environment variable: + + GIT_SSL_NO_VERIFY=true git clone https://code.acperkins.com/acp/workstation.git + +This will clone without checking the validation of the root certificates. This +should only be done for the initial clone. The playbooks should be configured to +set up SSL trust for all future actions (for example by installing and +configuring the `mozilla-rootcerts-openssl` package on NetBSD, or the +`ca_root_nss` package on FreeBSD).