commit 5c13c923aa7ca03f0f250d153e66d690c2863fbf
Author: Radar231 <radar231@gmail.com>
Date:   Thu Dec 21 18:19:40 2023 -0500

    initial checkin

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2284146
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# dotfile playbook
+
+* this playbook with copy the dotfiles from the (dotfile repository)[https://git.radar231.com/radar231/dotfiles]
+into the selected home directory for the selected user.
+
+* the following variables are required;
+    * username
+    * groupname
+    * homedir
+
+* the playbook can be run with the following command line;
+
+ansible-playbook -i <inventory file | IP,> -e "username=<user name>" -e "groupname=<group name> -e "homedir=<home dir>" dotfiles.yml
+
+ie;
+
+ansible-playbook -i 192.168.20.99, -e "username=someuser" -e "groupname=somegroup>" -e "homedir=/home/someuser" dotfiles.yml
+
diff --git a/dotfiles.yml b/dotfiles.yml
new file mode 100644
index 0000000..83e71c3
--- /dev/null
+++ b/dotfiles.yml
@@ -0,0 +1,35 @@
+---
+
+- hosts: all
+  gather_facts: true
+  remote_user: root
+
+  vars:
+    username: "rmorrow"
+    groupname: "rmorrow"
+    homedir: "/home/rmorrow"
+
+  tasks:
+
+    #######################################################
+    - name: retrieve dotfiles repository
+      ansible.builtin.git:
+        repo: 'https://git.radar231.com/radar231/dotfiles'
+        dest: "/tmp/dotfiles_repo"
+      
+    #######################################################
+    - name: copy dotfiles home dir
+      shell:
+        cmd: rsync --recursive --verbose --exclude '.git' --chown "{{ username }}:{{ groupname }}" /tmp/dotfiles_repo/ "{{ homedir }}/"
+
+    #######################################################
+    - name: clean up cloned repository
+      shell:
+        cmd: rm -rf /tmp/dotfiles_repo
+
+    #######################################################
+    - name: remove repository README.md file from dest home directory
+      shell:
+        cmd: rm "{{ homedir }}/README.md"
+
+# EOF