From 3adb82ff1fe60d69c97f78d2f4cf2e774cc52e74 Mon Sep 17 00:00:00 2001 From: Tung Bui Date: Sat, 27 Jan 2024 12:37:07 +0700 Subject: [PATCH 1/7] gitlabCI: use common template --- topics/gitlabci/README.md | 58 ++++++++++++++----- topics/gitlabci/advanced/REAME.md | 3 + .../{hello-world => basic}/.gitlab-ci.yml | 0 3 files changed, 48 insertions(+), 13 deletions(-) create mode 100644 topics/gitlabci/advanced/REAME.md rename topics/gitlabci/{hello-world => basic}/.gitlab-ci.yml (100%) diff --git a/topics/gitlabci/README.md b/topics/gitlabci/README.md index 0698a52..468b006 100644 --- a/topics/gitlabci/README.md +++ b/topics/gitlabci/README.md @@ -1,23 +1,55 @@ -# Gitlab CI getting started +## What is Gitlab CI? -- https://docs.gitlab.com/ee/ci/ +### Overview -# Create and run your first GitLab CI/CD pipeline +GitLab CI/CD is a software development tool that allows organizations to implement “continuous” methodologies, including continuous integration (CI), continuous delivery (CD), and continuous deployment (also abbreviated to CD). -- https://docs.gitlab.com/ee/ci/quick_start/ +### Gitlab CI workflow -# Gitlab public +- None -- https://gitlab.com/ +### Official website documentation of Gitlab CI -# Gitlab self deployment +- https://docs.gitlab.com/ (CI/CD page) -- https://docs.gitlab.com/ee/install/install_methods.html +## Prerequisites -# GitLab CI/CD examples +- Basic linux command line skill, CICD, YAML -- https://docs.gitlab.com/ee/ci/examples/ +## Installation -# Advanced -## Using GitLab CI/CD with a GitHub repository -- https://docs.gitlab.com/ee/ci/ci_cd_for_external_repos/github_integration.html +### How to install Gitlab CI? + +#### Gitlab public + +- Use https://gitlab.com/ (No need to install) + +#### Gitlab self deployment + +- https://docs.gitlab.com/ee/install/install_methods.html + +##### Basics of Gitlab CI + +### Getting started with Gitlab CI + +- Visit https://docs.gitlab.com/ee/ci/quick_start/ for a comprehensive introduction. + +### Gitlab CI Hello World + +- Check the [basic/](./basic/) directory to create a simple Gitlab CI demo. + +## Beyond the Basics + +### Hands-On Example + +- Explore a practical hands-on example in the [Gitlab CI examples](https://docs.gitlab.com/ee/ci/examples/) for more Gitlab CI concepts + +## More... + +### Gitlab CI YAML syntax reference + +- https://docs.gitlab.com/ee/ci/yaml/ + +### Recommended Books + +- None diff --git a/topics/gitlabci/advanced/REAME.md b/topics/gitlabci/advanced/REAME.md new file mode 100644 index 0000000..8396f47 --- /dev/null +++ b/topics/gitlabci/advanced/REAME.md @@ -0,0 +1,3 @@ +## Using GitLab CI/CD with a GitHub repository + +- https://docs.gitlab.com/ee/ci/ci_cd_for_external_repos/github_integration.html diff --git a/topics/gitlabci/hello-world/.gitlab-ci.yml b/topics/gitlabci/basic/.gitlab-ci.yml similarity index 100% rename from topics/gitlabci/hello-world/.gitlab-ci.yml rename to topics/gitlabci/basic/.gitlab-ci.yml From 75943aae5e2ab356a0221f2a23dd0219fbb9b5bf Mon Sep 17 00:00:00 2001 From: Tung Bui Date: Sat, 27 Jan 2024 12:37:53 +0700 Subject: [PATCH 2/7] gitlabCI: use common template.v1 --- topics/gitlabci/README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/topics/gitlabci/README.md b/topics/gitlabci/README.md index 468b006..fcdf3a5 100644 --- a/topics/gitlabci/README.md +++ b/topics/gitlabci/README.md @@ -43,6 +43,7 @@ GitLab CI/CD is a software development tool that allows organizations to impleme ### Hands-On Example - Explore a practical hands-on example in the [Gitlab CI examples](https://docs.gitlab.com/ee/ci/examples/) for more Gitlab CI concepts +- Check the [advanced/](./advanced//) for more Gitlab CI concepts ## More... From 3a267288316ff3bf4da9af5e237dad97a967c97c Mon Sep 17 00:00:00 2001 From: Tung Bui Date: Sat, 27 Jan 2024 13:53:25 +0700 Subject: [PATCH 3/7] groovy: use common template.v1 --- topics/groovy/README.md | 46 +++++++++++++++++-- topics/groovy/{helloworld => basic}/README.md | 0 .../basic-concept.groovy | 0 3 files changed, 42 insertions(+), 4 deletions(-) rename topics/groovy/{helloworld => basic}/README.md (100%) rename topics/groovy/{helloworld => basic}/basic-concept.groovy (100%) mode change 100755 => 100644 diff --git a/topics/groovy/README.md b/topics/groovy/README.md index a4faa76..72eadc4 100644 --- a/topics/groovy/README.md +++ b/topics/groovy/README.md @@ -1,9 +1,47 @@ -# Why groovy? +## What is Groovy? + +### Overview + +- Groovy is a powerful, optionally typed and dynamic language, with static-typing and static compilation capabilities, for the Java platform aimed at improving developer productivity thanks to a concise, familiar and easy to learn . - Groovy is being used for developing the Jenkins pipeline, so it better if we have the knowledge about this language -# Install groovy +### Groovy workflow + +- None + +### Official website documentation of Groovy + +- https://groovy-lang.org/documentation.html + +## Prerequisites + +- None + +## Installation + +### How to install Groovy? + - See https://groovy-lang.org/install.html (I prefer using SDK man) - Facing missing java issue while installing: Visit: [groovy-with-sdk-missing-java.md](.././../troubleshooting/installation/groovy-with-sdk-missing-java.md) -# Basic groovy scripting -- See [helloworld](./helloworld/) +## Basics of Groovy + +### Groovy Hello World + +- Check the [basic/](./basic/) directory to create a simple Groovy demo. + +## Beyond the Basics + +### Hands-On Example + +- TODO + +## More... + +### Groovy extra resources + +- TODO + +### Recommended Books + +- TODO diff --git a/topics/groovy/helloworld/README.md b/topics/groovy/basic/README.md similarity index 100% rename from topics/groovy/helloworld/README.md rename to topics/groovy/basic/README.md diff --git a/topics/groovy/helloworld/basic-concept.groovy b/topics/groovy/basic/basic-concept.groovy old mode 100755 new mode 100644 similarity index 100% rename from topics/groovy/helloworld/basic-concept.groovy rename to topics/groovy/basic/basic-concept.groovy From f85721b6a685072fac2408dc56d3c14a576e16d4 Mon Sep 17 00:00:00 2001 From: Tung Bui Date: Sat, 27 Jan 2024 14:05:24 +0700 Subject: [PATCH 4/7] helm: use common template --- topics/helm/README.md | 49 +++++++++++++++++-- .../hands-on/deploy-jenkins/README.md | 0 .../hands-on/deploy-jenkins/cleanup.sh | 0 .../hands-on/deploy-jenkins/deploy.sh | 0 .../hands-on/deploy-jenkins/jenkins-sa.yaml | 0 .../deploy-jenkins/jenkins-values.yaml | 0 .../deploy-jenkins/jenkins-volume.yaml | 0 .../hands-on/deploy-jenkins/local-debug.sh | 0 .../{ => advanced}/tungleo-chart/.helmignore | 0 .../{ => advanced}/tungleo-chart/Chart.yaml | 0 .../tungleo-chart/templates/NOTES.txt | 0 .../tungleo-chart/templates/_helpers.tpl | 0 .../tungleo-chart/templates/deployment.yaml | 0 .../tungleo-chart/templates/hpa.yaml | 0 .../tungleo-chart/templates/ingress.yaml | 0 .../tungleo-chart/templates/service.yaml | 0 .../templates/serviceaccount.yaml | 0 .../templates/tests/test-connection.yaml | 0 .../{ => advanced}/tungleo-chart/values.yaml | 0 .../{hello-world => basic}/helm-helloworld.sh | 0 20 files changed, 46 insertions(+), 3 deletions(-) rename topics/helm/{ => advanced}/hands-on/deploy-jenkins/README.md (100%) rename topics/helm/{ => advanced}/hands-on/deploy-jenkins/cleanup.sh (100%) mode change 100755 => 100644 rename topics/helm/{ => advanced}/hands-on/deploy-jenkins/deploy.sh (100%) mode change 100755 => 100644 rename topics/helm/{ => advanced}/hands-on/deploy-jenkins/jenkins-sa.yaml (100%) rename topics/helm/{ => advanced}/hands-on/deploy-jenkins/jenkins-values.yaml (100%) rename topics/helm/{ => advanced}/hands-on/deploy-jenkins/jenkins-volume.yaml (100%) rename topics/helm/{ => advanced}/hands-on/deploy-jenkins/local-debug.sh (100%) mode change 100755 => 100644 rename topics/helm/{ => advanced}/tungleo-chart/.helmignore (100%) rename topics/helm/{ => advanced}/tungleo-chart/Chart.yaml (100%) rename topics/helm/{ => advanced}/tungleo-chart/templates/NOTES.txt (100%) rename topics/helm/{ => advanced}/tungleo-chart/templates/_helpers.tpl (100%) rename topics/helm/{ => advanced}/tungleo-chart/templates/deployment.yaml (100%) rename topics/helm/{ => advanced}/tungleo-chart/templates/hpa.yaml (100%) rename topics/helm/{ => advanced}/tungleo-chart/templates/ingress.yaml (100%) rename topics/helm/{ => advanced}/tungleo-chart/templates/service.yaml (100%) rename topics/helm/{ => advanced}/tungleo-chart/templates/serviceaccount.yaml (100%) rename topics/helm/{ => advanced}/tungleo-chart/templates/tests/test-connection.yaml (100%) rename topics/helm/{ => advanced}/tungleo-chart/values.yaml (100%) rename topics/helm/{hello-world => basic}/helm-helloworld.sh (100%) diff --git a/topics/helm/README.md b/topics/helm/README.md index e05add1..151c4e9 100644 --- a/topics/helm/README.md +++ b/topics/helm/README.md @@ -1,6 +1,49 @@ -# How to install Helm +## What is Helm? + +### Overview + +- Helm is the package manager for Kubernetes + +### Helm workflow + +- None + +### Official website documentation of Helm + +- https://helm.sh/docs/ + +## Prerequisites + +- None + +## Installation + +### How to install Helm? + - https://helm.sh/docs/intro/install/ -# Helm quick start guide + +## Basics of Helm + +### Helm quick start + - https://helm.sh/docs/intro/quickstart/ -# Helm cheatsheet + +### Helm Hello World + +- Check the [basic/](./basic/) directory to create a simple Helm demo. + +## Beyond the Basics + +### Hands-On Example + +- Check the [advanced/](./advanced/) directory for more Helm examples. + +## More... + +### Helm cheatsheet + - https://helm.sh/docs/intro/cheatsheet/ + +### Recommended Books + +- TODO diff --git a/topics/helm/hands-on/deploy-jenkins/README.md b/topics/helm/advanced/hands-on/deploy-jenkins/README.md similarity index 100% rename from topics/helm/hands-on/deploy-jenkins/README.md rename to topics/helm/advanced/hands-on/deploy-jenkins/README.md diff --git a/topics/helm/hands-on/deploy-jenkins/cleanup.sh b/topics/helm/advanced/hands-on/deploy-jenkins/cleanup.sh old mode 100755 new mode 100644 similarity index 100% rename from topics/helm/hands-on/deploy-jenkins/cleanup.sh rename to topics/helm/advanced/hands-on/deploy-jenkins/cleanup.sh diff --git a/topics/helm/hands-on/deploy-jenkins/deploy.sh b/topics/helm/advanced/hands-on/deploy-jenkins/deploy.sh old mode 100755 new mode 100644 similarity index 100% rename from topics/helm/hands-on/deploy-jenkins/deploy.sh rename to topics/helm/advanced/hands-on/deploy-jenkins/deploy.sh diff --git a/topics/helm/hands-on/deploy-jenkins/jenkins-sa.yaml b/topics/helm/advanced/hands-on/deploy-jenkins/jenkins-sa.yaml similarity index 100% rename from topics/helm/hands-on/deploy-jenkins/jenkins-sa.yaml rename to topics/helm/advanced/hands-on/deploy-jenkins/jenkins-sa.yaml diff --git a/topics/helm/hands-on/deploy-jenkins/jenkins-values.yaml b/topics/helm/advanced/hands-on/deploy-jenkins/jenkins-values.yaml similarity index 100% rename from topics/helm/hands-on/deploy-jenkins/jenkins-values.yaml rename to topics/helm/advanced/hands-on/deploy-jenkins/jenkins-values.yaml diff --git a/topics/helm/hands-on/deploy-jenkins/jenkins-volume.yaml b/topics/helm/advanced/hands-on/deploy-jenkins/jenkins-volume.yaml similarity index 100% rename from topics/helm/hands-on/deploy-jenkins/jenkins-volume.yaml rename to topics/helm/advanced/hands-on/deploy-jenkins/jenkins-volume.yaml diff --git a/topics/helm/hands-on/deploy-jenkins/local-debug.sh b/topics/helm/advanced/hands-on/deploy-jenkins/local-debug.sh old mode 100755 new mode 100644 similarity index 100% rename from topics/helm/hands-on/deploy-jenkins/local-debug.sh rename to topics/helm/advanced/hands-on/deploy-jenkins/local-debug.sh diff --git a/topics/helm/tungleo-chart/.helmignore b/topics/helm/advanced/tungleo-chart/.helmignore similarity index 100% rename from topics/helm/tungleo-chart/.helmignore rename to topics/helm/advanced/tungleo-chart/.helmignore diff --git a/topics/helm/tungleo-chart/Chart.yaml b/topics/helm/advanced/tungleo-chart/Chart.yaml similarity index 100% rename from topics/helm/tungleo-chart/Chart.yaml rename to topics/helm/advanced/tungleo-chart/Chart.yaml diff --git a/topics/helm/tungleo-chart/templates/NOTES.txt b/topics/helm/advanced/tungleo-chart/templates/NOTES.txt similarity index 100% rename from topics/helm/tungleo-chart/templates/NOTES.txt rename to topics/helm/advanced/tungleo-chart/templates/NOTES.txt diff --git a/topics/helm/tungleo-chart/templates/_helpers.tpl b/topics/helm/advanced/tungleo-chart/templates/_helpers.tpl similarity index 100% rename from topics/helm/tungleo-chart/templates/_helpers.tpl rename to topics/helm/advanced/tungleo-chart/templates/_helpers.tpl diff --git a/topics/helm/tungleo-chart/templates/deployment.yaml b/topics/helm/advanced/tungleo-chart/templates/deployment.yaml similarity index 100% rename from topics/helm/tungleo-chart/templates/deployment.yaml rename to topics/helm/advanced/tungleo-chart/templates/deployment.yaml diff --git a/topics/helm/tungleo-chart/templates/hpa.yaml b/topics/helm/advanced/tungleo-chart/templates/hpa.yaml similarity index 100% rename from topics/helm/tungleo-chart/templates/hpa.yaml rename to topics/helm/advanced/tungleo-chart/templates/hpa.yaml diff --git a/topics/helm/tungleo-chart/templates/ingress.yaml b/topics/helm/advanced/tungleo-chart/templates/ingress.yaml similarity index 100% rename from topics/helm/tungleo-chart/templates/ingress.yaml rename to topics/helm/advanced/tungleo-chart/templates/ingress.yaml diff --git a/topics/helm/tungleo-chart/templates/service.yaml b/topics/helm/advanced/tungleo-chart/templates/service.yaml similarity index 100% rename from topics/helm/tungleo-chart/templates/service.yaml rename to topics/helm/advanced/tungleo-chart/templates/service.yaml diff --git a/topics/helm/tungleo-chart/templates/serviceaccount.yaml b/topics/helm/advanced/tungleo-chart/templates/serviceaccount.yaml similarity index 100% rename from topics/helm/tungleo-chart/templates/serviceaccount.yaml rename to topics/helm/advanced/tungleo-chart/templates/serviceaccount.yaml diff --git a/topics/helm/tungleo-chart/templates/tests/test-connection.yaml b/topics/helm/advanced/tungleo-chart/templates/tests/test-connection.yaml similarity index 100% rename from topics/helm/tungleo-chart/templates/tests/test-connection.yaml rename to topics/helm/advanced/tungleo-chart/templates/tests/test-connection.yaml diff --git a/topics/helm/tungleo-chart/values.yaml b/topics/helm/advanced/tungleo-chart/values.yaml similarity index 100% rename from topics/helm/tungleo-chart/values.yaml rename to topics/helm/advanced/tungleo-chart/values.yaml diff --git a/topics/helm/hello-world/helm-helloworld.sh b/topics/helm/basic/helm-helloworld.sh similarity index 100% rename from topics/helm/hello-world/helm-helloworld.sh rename to topics/helm/basic/helm-helloworld.sh From 8ccbbb72314fa27269cfe52b98e131523cc387aa Mon Sep 17 00:00:00 2001 From: Tung Bui Date: Sat, 27 Jan 2024 14:06:00 +0700 Subject: [PATCH 5/7] helm: use common template.v1 --- topics/helm/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/topics/helm/README.md b/topics/helm/README.md index 151c4e9..35a29f7 100644 --- a/topics/helm/README.md +++ b/topics/helm/README.md @@ -14,7 +14,7 @@ ## Prerequisites -- None +- K8s, docker, linux ## Installation From 43b00a6d1a9e52d7a96d1ee176f0b15a28f8508c Mon Sep 17 00:00:00 2001 From: Tung Bui Date: Sat, 27 Jan 2024 14:11:11 +0700 Subject: [PATCH 6/7] jenkins: use common template --- topics/jenkins/README.md | 54 ++++++++++++++++--- topics/jenkins/advanced/README.md | 1 + .../Jenkins-Hello-World.md | 0 .../MyFirstPipeline.groovy | 0 .../PipelineWithParallelStages.groovy | 0 .../deploy/docker-compose/README.md | 0 .../deploy/docker-compose/docker-compose.yml | 0 7 files changed, 49 insertions(+), 6 deletions(-) create mode 100644 topics/jenkins/advanced/README.md rename topics/jenkins/{helloworld => basic}/Jenkins-Hello-World.md (100%) rename topics/jenkins/{helloworld => basic}/MyFirstPipeline.groovy (100%) rename topics/jenkins/{helloworld => basic}/PipelineWithParallelStages.groovy (100%) rename topics/jenkins/{ => basic}/deploy/docker-compose/README.md (100%) rename topics/jenkins/{ => basic}/deploy/docker-compose/docker-compose.yml (100%) diff --git a/topics/jenkins/README.md b/topics/jenkins/README.md index 3b7a966..1c2d754 100644 --- a/topics/jenkins/README.md +++ b/topics/jenkins/README.md @@ -1,11 +1,53 @@ -# How to install Jenkins +## What is Jenkins? + +### Overview + +- Jenkins is the package manager for Kubernetes + +### Jenkins workflow + +- None + +### Official website documentation of Jenkins + +- https://www.jenkins.io/doc/ + +## Prerequisites + +- K8s, docker, linux + +## Installation + +### How to install Jenkins? + - https://www.jenkins.io/doc/book/installing/ -# Learn Jenkins Basics +### Install Jenkins with Docker + +- See [deploy-jenkins/README.md](../Jenkins/basic/deploy-jenkins/README.md) + +## Basics of Jenkins + +### Jenkins getting started + - https://www.jenkins.io/doc/book/pipeline/getting-started/ -# Install Jenkins with Helm -- See [deploy-jenkins/README.md](../helm/hands-on/deploy-jenkins/README.md) +### Jenkins Hello World + +- See: [Jenkins Hello world](./basic/Jenkins-Hello-World.md) + +## Beyond the Basics + +### Hands-On Example + +- Check the [advanced/](./advanced/) directory for more Jenkins examples. + +## More... + +### Jenkins cheatsheet + +- None + +### Recommended Books -# Jenkins Helloworld Hands on -- See: [Jenkins Hello world](./helloworld/Jenkins-Hello-World.md) +- None diff --git a/topics/jenkins/advanced/README.md b/topics/jenkins/advanced/README.md new file mode 100644 index 0000000..4640904 --- /dev/null +++ b/topics/jenkins/advanced/README.md @@ -0,0 +1 @@ +# TODO diff --git a/topics/jenkins/helloworld/Jenkins-Hello-World.md b/topics/jenkins/basic/Jenkins-Hello-World.md similarity index 100% rename from topics/jenkins/helloworld/Jenkins-Hello-World.md rename to topics/jenkins/basic/Jenkins-Hello-World.md diff --git a/topics/jenkins/helloworld/MyFirstPipeline.groovy b/topics/jenkins/basic/MyFirstPipeline.groovy similarity index 100% rename from topics/jenkins/helloworld/MyFirstPipeline.groovy rename to topics/jenkins/basic/MyFirstPipeline.groovy diff --git a/topics/jenkins/helloworld/PipelineWithParallelStages.groovy b/topics/jenkins/basic/PipelineWithParallelStages.groovy similarity index 100% rename from topics/jenkins/helloworld/PipelineWithParallelStages.groovy rename to topics/jenkins/basic/PipelineWithParallelStages.groovy diff --git a/topics/jenkins/deploy/docker-compose/README.md b/topics/jenkins/basic/deploy/docker-compose/README.md similarity index 100% rename from topics/jenkins/deploy/docker-compose/README.md rename to topics/jenkins/basic/deploy/docker-compose/README.md diff --git a/topics/jenkins/deploy/docker-compose/docker-compose.yml b/topics/jenkins/basic/deploy/docker-compose/docker-compose.yml similarity index 100% rename from topics/jenkins/deploy/docker-compose/docker-compose.yml rename to topics/jenkins/basic/deploy/docker-compose/docker-compose.yml From 385d0d9dfce6f414f3ba271c225b4bf2973f36d1 Mon Sep 17 00:00:00 2001 From: Tung Bui Date: Sat, 27 Jan 2024 14:11:42 +0700 Subject: [PATCH 7/7] jenkins: use common template.v1 --- topics/jenkins/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/topics/jenkins/README.md b/topics/jenkins/README.md index 1c2d754..b089426 100644 --- a/topics/jenkins/README.md +++ b/topics/jenkins/README.md @@ -2,7 +2,7 @@ ### Overview -- Jenkins is the package manager for Kubernetes +- The leading open source automation server, Jenkins provides hundreds of plugins to support building, deploying and automating any project. ### Jenkins workflow