Build documentation as part of persistence layer

playbook.yaml

@@ -56,8 +56,8 @@
   hosts: localhost
   connection: local
   tags:
-  - install_doxygen
-  - install_cross_compile_toolchain
+    - install_doxygen
+    - install_cross_compile_toolchain
 
   tasks:
   - name: Install build-essential
@@ -190,8 +190,8 @@
   hosts: localhost
   connection: local
   tags:
-  - install_cross_compile_toolchain
-  - install_doxygen
+    - install_cross_compile_toolchain
+    - install_doxygen
 
   vars:
     cmake_version: "3.27.9"
@@ -249,6 +249,7 @@
     fprime_version: "v3.4.0"
     arduino_cli_cmake_wrapper_version: "94c3145e5ea4a0a48dc3f70560dfb8a"
     fprime_led_blinker_version: "{{ fprime_version }}"
+    bundler_version: 2.4.22
 
   tasks:
   - name: Update OS to point python to python3
@@ -302,13 +303,83 @@
       cmd: fprime-util generate --ut
       chdir: /home/kasm-default-profile/fprime-workshop-led-blinker
       executable: /bin/bash
-  - name: Build fprime led blinker unit tests
+  - name: Build and run fprime led blinker unit tests
     shell:
-      cmd: fprime-util check 1> /tmp/fprime_workshop_led_blinker_build_output.txt
+      cmd: fprime-util check
       chdir: /home/kasm-default-profile/fprime-workshop-led-blinker
       executable: /bin/bash
   - name: Delete fprime led blinker repo
     shell: rm -rf /home/kasm-default-profile/fprime-workshop-led-blinker
+  - name: Install Ruby
+    apt:
+      name: ruby-full
+      update_cache: yes
+  - name: Run gem install for bundler
+    shell:
+      cmd: "gem install bundler -v {{ bundler_version }}"
+  - name: Clone fprime {{ fprime_version }}
+    shell:
+      cmd: git clone --recursive https://github.com/nasa/fprime.git
+      chdir: /home/kasm-default-profile/
+      executable: /bin/bash
+  - name: Checkout {{ fprime_version }} in fprime repo
+    shell:
+      cmd: git checkout {{ fprime_version }}
+      chdir: /home/kasm-default-profile/fprime
+      executable: /bin/bash
+  - name: Generate Gemfile using bundler in fprime/docs
+    shell:
+      cmd: bundler init
+      chdir: /home/kasm-default-profile/fprime/docs
+      executable: /bin/bash
+  - name: Add jekyll to Gemfile in fprime/docs using bundler
+    shell:
+      cmd: bundler add jekyll
+      chdir: /home/kasm-default-profile/fprime/docs
+      executable: /bin/bash
+  - name: Setup jekyll scaffolding in fprime/docs using bundler
+    shell:
+      cmd: bundle exec jekyll new --force --skip-bundle .
+      chdir: /home/kasm-default-profile/fprime/docs
+      executable: /bin/bash
+  - name: Add fprime-community/fprime-theme@main to Gemfile in fprime/docs using bundler
+    shell:
+      cmd: echo 'gem "fprime-theme", git{{ ":" }} "https://github.com/fprime-community/fprime-theme"' >> Gemfile
+      chdir: /home/kasm-default-profile/fprime/docs
+      executable: /bin/bash
+  - name: Get contents of fprime/docs/Gemfile
+    shell:
+      cmd: cat Gemfile
+      chdir: /home/kasm-default-profile/fprime/docs
+      executable: /bin/bash
+    register: fprime_docs_gemfile
+  - name: Display fprime/docs/Gemfile
+    debug:
+      msg: "fprime/docs/Gemfile = {{ fprime_docs_gemfile.stdout }}"
+  - name: Install jekyll and fprime-theme from Gemfile.lock in fprime/docs using bundler
+    shell:
+      cmd: bundler install
+      chdir: /home/kasm-default-profile/fprime/docs
+      executable: /bin/bash
+  - name: Restore changes to fprime/docs/_config.yml
+    shell:
+      cmd: git restore _config.yml
+      chdir: /home/kasm-default-profile/fprime/docs
+      executable: /bin/bash
+  - name: Build jekyll site in fprime/docs/_site using bundler
+    shell:
+      cmd: bundle exec jekyll build
+      chdir: /home/kasm-default-profile/fprime/docs
+      executable: /bin/bash
+  - name: Copy fprime/docs to Desktop
+    copy:
+      src: /home/kasm-default-profile/fprime/docs
+      dest: /home/kasm-default-profile/Desktop
+  - name: Remove fprime from /home/kasm-default-profile
+    shell:
+      cmd: rm -rf fprime
+      chdir: /home/kasm-default-profile
+      executable: /bin/bash
 
 -
   # install arduino-cli
@@ -436,7 +507,8 @@
   hosts: localhost
   connection: local
   gather_facts: yes
-  tags: install_doxygen
+  tags:
+    - install_doxygen
 
   vars:
     doxygen_version: "1.9.6"