Merge pull request #3 from ankudinov/avd-extended-workshop

init ext avd workshop and move it to construction

.github/workflows/publish-pages-on-forks.yml

@@ -34,12 +34,18 @@ jobs:
           echo "repo_name: ${{ github.event.repository.name }}" >> docs/assets/data/github.yml
           echo "repository: ${{ github.repository }}" >> docs/assets/data/github.yml
 
+      - name: find-branch
+        id: find_branch
+        run: |
+          echo "branch=${GITHUB_HEAD_REF:-${GITHUB_REF#refs/heads/}}" >> $GITHUB_OUTPUT
+
       - name: Replace URLs to match git repo ✂️
         run: |
           grep -rl '${localEnv:GITHUB_REPOSITORY}' . --exclude-dir .git | xargs sed -i 's@${localEnv:GITHUB_REPOSITORY}@'"${{ github.repository }}"'@g'
           grep -rl '{{gh.repo_name}}' . --exclude-dir .git | xargs sed -i 's/{{gh.repo_name}}/'"${{ github.event.repository.name }}"'/g'
           grep -rl '{{gh.org_name}}' . --exclude-dir .git | xargs sed -i 's/{{gh.org_name}}/'"${{ github.repository_owner }}"'/g'
           grep -rl '{{gh.repository}}' . --exclude-dir .git | xargs sed -i 's@{{gh.repository}}@'"${{ github.repository }}"'@g'
+          grep -rl '{{gh.branch}}' . --exclude-dir .git | xargs sed -i 's@{{gh.branch}}@'"${{ steps.find_branch.outputs.branch }}"'@g'
 
       - name: Setup Python3 🐍
         uses: actions/setup-python@v5

docs/avd-avd-extended-workshop--part-1.md

@@ -2,7 +2,7 @@
 
 !!! Warning "Lab Documents Not Finished"
 
-    DO NOT ENTER!
+    DO NOT ENTER! :skull_and_crossbones:{ .heartbeat }
 
     ![stay back](assets/img/pexels-danne-555709.jpg)
 
@@ -12,15 +12,15 @@
 
 ## Demo Details
 
-!!! Success "Container Requirements"
+!!! Warning "Container Requirements"
 
-    CPUs: 4  
-    Memory: 16 GB  
-    Storage: 32 GB  
+    CPUs: 8  
+    Memory: 32 GB  
+    Storage: 64 GB  
 
-    :material-checkbox-marked-outline: Works with default Codespaces sizing!
+    :material-alert-circle-outline:{ .heartbeat } Please request high spec Codespace machines from [Github support](https://support.github.com/) first!
 
-[Start "AVD Extended Workshop, Part 1" in Codespace](https://codespaces.new/{{gh.repository}}?quickstart=1&devcontainer_path=.devcontainer%2Favd-avd-extended-workshop--part-1%2Fdevcontainer.json){ .md-button .md-button--primary target=_blank}
+[Start "AVD Extended Workshop, Part 1" in Codespace](https://codespaces.new/{{gh.repository}}/tree/{{gh.branch}}?quickstart=1&devcontainer_path=.devcontainer%2Favd-avd-extended-workshop--part-1%2Fdevcontainer.json){ .md-button .md-button--primary target=_blank}
 
 [Slides](https://{{gh.org_name}}.github.io/{{gh.repo_name}}/slides/avd-avd-extended-workshop--part-1.html){ target=_blank }  
 [PDF Slides](https://{{gh.org_name}}.github.io/{{gh.repo_name}}/pdfs/avd-avd-extended-workshop--part-1.pdf){ target=_blank }  

mkdocs.yml

@@ -131,10 +131,10 @@ nav:
     - Demo:
       - CVaaS and AVD Demo, EVPN MLAG: cvaas-cvaas-and-avd-demo--evpn-mlag/cvaas-cvaas-and-avd-demo--evpn-mlag.md
       - CVaaS and AVD Demo, EVPN AA: cvaas-cvaas-and-avd-demo--evpn-aa/cvaas-cvaas-and-avd-demo--evpn-aa.md
-  - AVD:
-    - Workshops:
+  # - AVD:
+  #   - Workshops:
       # - AVD Extended Workshop: avd/workshops/avd-extended-workshop/avd-extended-workshop.md
-      - AVD Extended Workshop, Part 1: avd-avd-extended-workshop--part-1.md
+      # - AVD Extended Workshop, Part 1: avd-avd-extended-workshop--part-1.md
     # - Examples:
     #   - Single DC L3LS: avd-single-dc-l3ls.md
   - cLab:
@@ -143,3 +143,4 @@ nav:
   - Construction Area:
     - Warning: construction-area.md
     - Single DC L3LS: avd-single-dc-l3ls.md
+    - AVD Extended Workshop, Part 1: avd-avd-extended-workshop--part-1.md

slides/avd-avd-extended-workshop--part-1.md

@@ -9,7 +9,7 @@ paginate: true
 math: mathjax
 style: |
     :root {
-      background: linear-gradient(to bottom, #000000, #434343);
+      background: linear-gradient(to bottom, #1e3744, #301B29);
     }
     img[alt~="custom"] {
       float: right;
@@ -29,44 +29,168 @@ style: |
       background-color: transparent;
     }
     pre {
-        background: linear-gradient(to top, #000000, #434343);
+        background: linear-gradient(to top, #1e3744, #301B29);
         background-color: transparent;
     }
 ---
 
-# AVD Extended Workshop, Part 1
+# AVD Extended Workshop
 
 <!-- Do not add page number on this slide -->
 <!--
 _paginate: false
 -->
 
-```text
-AVD Extended Workshop, Part 1 Demo
-Petr Ankudinov
-                                    29/04/2024
-```
+`Intro into Ansible, Ansible AVD, Git and VSCode for new and existing AVD users`
 
-![bg right](img/leonardo-yip-unsplash.jpg)
+![bg left fit](img/avd-logo.webp)
 
 ---
 
-# Agenda
+# What is this Workshop about?
 
-<style scoped>section {font-size: 22px;}</style>
+<!-- Add footer starting from this slide -->
+<!--
+footer: 'Arista Ansible AVD Extended Workshop, 2023'
+-->
+
+<style scoped>section {font-size: 14px;}</style>
 
 ![bg right opacity:75%](img/pexels-suzy-hazelwood-1226398.jpg)
 
-- item1
-- item2
-- item3
+- This workshop is split into 3 sections. Each section takes around 2 hours to complete. That can be done as a full day workshop or split into 3 separate sessions.
+- Topics:
+
+  > - Section 1 - Intro:
+  >   - Introducing the Tools
+  >   - Before We Start - get lab environment up and running
+  >   - Prepare Github Codespaces Environment
+  >   - Run AVD Playbooks
+  >   - Make Some Changes in AVD Repository
+  > - Section 2 - Ansible and Git 101
+  > - Section 3 - Common AVD provisioning cases
+
+- Make a break when you see a slide with a coffee cup ☕️
+- Ask questions at any time!
+
+---
+
+# What is NOT covered in this Workshop?
+
+<style scoped>section {font-size: 22px;}</style>
+
+- This workshop is not a deep dive into each and every topic. It is covering some advanced concepts, but you may need additional documentation and training to understand every topic in details.  
+  For additional information please refer to the following resources:
+  - [Ansible AVD Documentation](https://avd.arista.com/)
+  - [VSCode Documentation](https://code.visualstudio.com/docs)
+  - [Git Documentation](https://git-scm.com/doc) - Pro Git book is a good start
+  - Container Trainings by [@jpetazzo](https://github.com/jpetazzo):
+    - [Github repository](https://github.com/jpetazzo/container.training)
+    - [Training materials](https://container.training/)
+- We are not going to use Arista CloudVision Portal (CVP) in this workshop. It provides a lot of advantages, but is not essential to understand the concepts covered.
+- If you will not find something you expect in this workshop, there can be 2 reasons:
+  - There are no plans to cover it
+  - It is waiting for your contribution to this repository! 🤝
+
+---
+
+# Requirements
+
+<style scoped>section {font-size: 24px;}</style>
+
+- You **MUST** have a Github account❗
+  Register [here](https://github.com/join).
+- You **MUST** have an [arista.com account](https://www.arista.com/en/login) to download cEOS-lab image for Codespaces.
+
+![bg left](img/pexels-towfiqu-barbhuiya-11412596.jpg)
+
+---
+
+# Introducing The Tools
+
+<style scoped>
+section {background: linear-gradient(to bottom, #000000, #434343);}
+ul {font-size: 12px;}
+</style>
+
+![bg left](img/pexels-pixabay-159591.jpg)
+
+`Section 1.1`
+
+> - The bird view on the tools we are going to use in this workshop.
+> - No details, they will come in a later sections. Just and overview.
+
+---
+
+# What is Git?
+
+![bg right fit](img/Git-Logo-1788C.png)
+
+- **In Short**:
+  > Git is a distributed version control system that tracks changes to a set of files and enables collaborative work.
+- **Fun Fact**:
+  > [Git was created](https://git-scm.com/book/en/v2/Getting-Started-A-Short-History-of-Git) by Linus Torvalds in 2005 to develop Linux kernel.
+
+---
+
+# What is GitHub?
+
+![bg right fit](img/github-mark-white.png)
+
+- GitHub is a Git repository hosting platform.
+- Allows to coordinate multiple local copies of the same repository and more.
+
+---
+
+# VSCode
+
+<style scoped>section {font-size: 24px;}</style>
+
+![bg right fit](img/code-stable.png)
+
+- Visual Studio Code is an extensible source-code editor developed by Microsoft and free to use.
+- This will be our main tool to work with Ansible AVD and interact with Git repositories in the workshop and production.
+- We are not going to cover VSCode installation and customization in this workshop. Check [VSCode documentation](https://code.visualstudio.com/docs) for details.
+
+---
+
+# Before We Start
+
+<style scoped>
+section {background: linear-gradient(to bottom, #000000, #434343);}
+ul {font-size: 12px;}
+</style>
+
+![bg left](img/pexels-pixabay-159591.jpg)
+
+`Section 1.2`
+
+> - How to get your lab environment up and running
+
+---
+
+# Lab Topology
+
+<style scoped>section {font-size: 22px;}</style>
+
+- The lab topology consists of:
+
+  - 2 spines
+  - 4 L3 leafs splitted into 2 MLAG pairs
+  - 2 L2 leafs ("iLO switches")
+
+![bg right fit](img/atd-l3ls.png)
 
 ---
 
 <style scoped>section {font-size: 45px;}</style>
 
 ![bg left opacity:75%](img/pexels-ann-h-7186206.jpg)
 
+<style scoped>
+section {background: linear-gradient(to bottom, #000000, #434343);}
+</style>
+
 # Q&A
 
 - [Ansible AVD](https://avd.arista.com/)