Browse code

Add implementation

Robert Cranston authored on 22/01/2022 10:19:09
Showing 1 changed files
... ...
@@ -21,6 +21,44 @@ After login, run `startx` to start the graphical environment.
21 21
 [Vagrant provider]: https://www.vagrantup.com/docs/providers
22 22
 [Vagrant box]: https://www.vagrantup.com/docs/boxes
23 23
 
24
+## Requirements
25
+
26
+[Collection][]s:
27
+
28
+-   [`community.general`][]
29
+
30
+[Role][]s:
31
+
32
+-   [`ansible-role-xsession`][]
33
+-   [`ansible-role-xwinwrap`][]
34
+-   [`ansible-role-dotfiles`][]
35
+-   [`ansible-role-firefox-extensions`][]
36
+
37
+Make sure requirements are satisfied by running
38
+
39
+```
40
+ansible-galaxy install -f -r requirements.yml
41
+```
42
+
43
+[collection]: https://docs.ansible.com/ansible/latest/user_guide/collections_using.html
44
+[`community.general`]: https://docs.ansible.com/ansible/latest/collections/community/general/index.html
45
+[role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html
46
+[`ansible-role-xsession`]: https://git.rcrnstn.net/rcrnstn/ansible-role-xsession
47
+[`ansible-role-xwinwrap`]: https://git.rcrnstn.net/rcrnstn/ansible-role-xwinwrap
48
+[`ansible-role-dotfiles`]: https://git.rcrnstn.net/rcrnstn/ansible-role-dotfiles
49
+[`ansible-role-firefox-extensions`]: https://git.rcrnstn.net/rcrnstn/ansible-role-firefox-extensions
50
+
51
+## Usage
52
+
53
+Run
54
+
55
+```
56
+ansible-playbook -K -i $host, desktop.yml
57
+```
58
+
59
+(note the comma!) replacing `$host` with the host you want to set up (can be
60
+`localhost`, perhaps adding `--connection=local`).
61
+
24 62
 ## License
25 63
 
26 64
 Licensed under the [ISC License][] unless otherwise noted, see the
Browse code

Add Vagrantfile

Robert Cranston authored on 22/01/2022 10:12:08
Showing 1 changed files
... ...
@@ -3,12 +3,23 @@
3 3
 An [Ansible][] [playbook][] for setting up a [desktop][] on [Debian][]-based
4 4
 [Linux distribution][]s.
5 5
 
6
+A [`Vagrantfile`][] is provided, try it out with the usual [`vagrant up`][].
7
+The [VirtualBox][] [Vagrant provider][] is configured to show the GUI. Some
8
+[Vagrant box][]es have a locked `vagrant` user, run `vagrant ssh -c 'echo
9
+vagrant:vagrant | sudo chpasswd'` to unlock and set the password to `vagrant`.
10
+After login, run `startx` to start the graphical environment.
11
+
6 12
 [`ansible-playbook-desktop`]: https://git.rcrnstn.net/rcrnstn/ansible-playbook-desktop
7 13
 [Ansible]: https://docs.ansible.com/ansible
8 14
 [playbook]: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html
9 15
 [desktop]: https://en.wikipedia.org/wiki/Desktop_computer
10 16
 [Debian]: https://en.wikipedia.org/wiki/Debian
11 17
 [Linux distribution]: https://en.wikipedia.org/wiki/Linux_distribution
18
+[`Vagrantfile`]: https://www.vagrantup.com/docs/vagrantfile
19
+[`vagrant up`]: https://www.vagrantup.com/docs/cli/up.html
20
+[VirtualBox]: https://en.wikipedia.org/wiki/VirtualBox
21
+[Vagrant provider]: https://www.vagrantup.com/docs/providers
22
+[Vagrant box]: https://www.vagrantup.com/docs/boxes
12 23
 
13 24
 ## License
14 25
 
Browse code

Add license

Robert Cranston authored on 22/01/2022 10:08:41
Showing 1 changed files
... ...
@@ -9,3 +9,11 @@ An [Ansible][] [playbook][] for setting up a [desktop][] on [Debian][]-based
9 9
 [desktop]: https://en.wikipedia.org/wiki/Desktop_computer
10 10
 [Debian]: https://en.wikipedia.org/wiki/Debian
11 11
 [Linux distribution]: https://en.wikipedia.org/wiki/Linux_distribution
12
+
13
+## License
14
+
15
+Licensed under the [ISC License][] unless otherwise noted, see the
16
+[`LICENSE`][] file.
17
+
18
+[ISC License]: https://choosealicense.com/licenses/isc/
19
+[`LICENSE`]: LICENSE
Browse code

Add readme

Robert Cranston authored on 22/01/2022 10:08:06
Showing 1 changed files
1 1
new file mode 100644
... ...
@@ -0,0 +1,11 @@
1
+# [`ansible-playbook-desktop`][]
2
+
3
+An [Ansible][] [playbook][] for setting up a [desktop][] on [Debian][]-based
4
+[Linux distribution][]s.
5
+
6
+[`ansible-playbook-desktop`]: https://git.rcrnstn.net/rcrnstn/ansible-playbook-desktop
7
+[Ansible]: https://docs.ansible.com/ansible
8
+[playbook]: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html
9
+[desktop]: https://en.wikipedia.org/wiki/Desktop_computer
10
+[Debian]: https://en.wikipedia.org/wiki/Debian
11
+[Linux distribution]: https://en.wikipedia.org/wiki/Linux_distribution