2 Commits
Author SHA1 Message Date
Marcin-Ramotowski 4901890d0e Created pipeline for Jenkins in Kubernetes cluster 2025-06-12 19:02:29 +00:00
Marcin-Ramotowski f55776916e Updated managed identity 2025-06-11 18:42:21 +00:00
5 changed files with 17 additions and 167 deletions
-32
View File
@@ -1,32 +0,0 @@
FROM debian:bookworm-slim
# Zapobiega interaktywnym promptom
ENV DEBIAN_FRONTEND=noninteractive
# Instalacja zależności systemowych
RUN apt-get update && apt-get install -y \
ca-certificates \
curl \
gnupg \
lsb-release \
apt-transport-https \
software-properties-common \
unzip \
bash \
&& rm -rf /var/lib/apt/lists/*
# Instalacja Azure CLI
RUN curl -sL https://aka.ms/InstallAzureCLIDeb | bash
# Instalacja kubectl (najświeższa stabilna wersja)
RUN curl -sLo /usr/local/bin/kubectl https://dl.k8s.io/release/v1.33.1/bin/linux/amd64/kubectl \
&& chmod +x /usr/local/bin/kubectl
# Instalacja kubelogin
RUN curl -sLo /tmp/kubelogin.zip https://github.com/Azure/kubelogin/releases/latest/download/kubelogin-linux-amd64.zip \
&& unzip -j /tmp/kubelogin.zip -d /usr/local/bin \
&& chmod +x /usr/local/bin/kubelogin \
&& rm /tmp/kubelogin.zip
# Domyślna komenda po starcie kontenera
CMD ["bash"]
+6 -2
View File
@@ -1,6 +1,7 @@
pipeline { pipeline {
agent { agent {
kubernetes { kubernetes {
defaultContainer 'kubectl'
yamlFile '.jenkins/podTemplate.yaml' yamlFile '.jenkins/podTemplate.yaml'
} }
} }
@@ -10,7 +11,6 @@ pipeline {
DEPLOY_FILES = 'namespace.yaml secret-store.yaml deploy.yaml ingress.yaml' DEPLOY_FILES = 'namespace.yaml secret-store.yaml deploy.yaml ingress.yaml'
NAMESPACE = 'user-microservice' NAMESPACE = 'user-microservice'
DEPLOYMENT = 'api' DEPLOYMENT = 'api'
CLIENT_ID = 'c302726f-fafb-4143-94c1-67a70975574a'
} }
stages { stages {
stage('Checkout') { stage('Checkout') {
@@ -24,8 +24,12 @@ pipeline {
steps { steps {
container('kubectl') { container('kubectl') {
sh ''' sh '''
az login --identity --client-id ${CLIENT_ID} az login --identity
az aks get-credentials --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --overwrite-existing az aks get-credentials --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --overwrite-existing
'''
}
container('kubelogin') {
sh '''
kubelogin convert-kubeconfig -l azurecli kubelogin convert-kubeconfig -l azurecli
''' '''
} }
+10 -4
View File
@@ -6,16 +6,22 @@ metadata:
spec: spec:
containers: containers:
- name: kubectl - name: kubectl
image: marcin00.azurecr.io/azure-cli-kubectl:latest image: mcr.microsoft.com/azure-cli:latest
command: command:
- cat - cat
tty: true tty: true
volumeMounts: volumeMounts:
- name: workspace-volume - name: azure-config
mountPath: /home/jenkins/agent mountPath: /root/.azure
- name: kubelogin
image: ghcr.io/int128/kubelogin:latest
command:
- cat
tty: true
volumes: volumes:
- name: workspace-volume - name: azure-config
emptyDir: {} emptyDir: {}
nodeSelector: nodeSelector:
-128
View File
@@ -1,128 +0,0 @@
# user-microservice-deploy
Repozytorium **GitOps** dla mikroserwisu [`user-microservice`](../user-microservice). Zawiera
**manifesty Kubernetes** wdrażanej aplikacji oraz **konfiguracje narzędzi CD** (ArgoCD, FluxCD,
`kubectl`) używane w pracy magisterskiej porównującej narzędzia CI/CD do budowania i wdrażania
aplikacji skonteneryzowanych.
Zgodnie z zasadą GitOps stan klastra jest odwzorowaniem zawartości tego repozytorium: potok CI
z repozytorium aplikacji aktualizuje tutaj tag obrazu, a narzędzie CD wprowadza tę zmianę na
klaster (przez synchronizację *pull* w ArgoCD/FluxCD lub przez `kubectl apply` w wariancie
imperatywnym).
---
## Spis treści
- [Rola w architekturze](#rola-w-architekturze)
- [Manifesty Kubernetes](#manifesty-kubernetes)
- [Wariant wdrożenia = branch](#wariant-wdrożenia--branch)
- [Narzędzia CD](#narzędzia-cd)
- [kubectl (Jenkins / Woodpecker)](#kubectl-jenkins--woodpecker)
- [ArgoCD](#argocd)
- [FluxCD](#fluxcd)
- [Argo Workflows](#argo-workflows)
- [Sekrety i tożsamość](#sekrety-i-tożsamość)
- [Powiązanie z repozytorium aplikacji](#powiązanie-z-repozytorium-aplikacji)
---
## Rola w architekturze
```
Potok CI (repo aplikacji) to repozytorium (GitOps) Klaster AKS
───────────────────────── ──────────────────────── ───────────
docker push (tag = SHA) ──▶ commit: "Changed deployed version to <SHA>" ──▶ narzędzie CD
(podmiana image w deploy.yaml) (apply / sync)
```
Historia commitów w tym repozytorium to zapis kolejnych wdrożeń — każdy commit typu
`... Changed deployed version to <SHA>` odpowiada jednemu przebiegowi potoku CI.
## Manifesty Kubernetes
Aplikacja wdrażana jest do namespace `user-microservice`. Zestaw manifestów:
| Plik | Zawartość |
|------|-----------|
| `namespace.yaml` | Namespace `user-microservice` |
| `deploy.yaml` | Deployment + Service dla **MySQL** oraz Deployment + Service dla **API** (to tutaj potok CI podmienia tag obrazu kontenera `api`) |
| `ingress.yaml` | Ingress (NGINX) wystawiający API pod `user-microservice.marcin00.pl` |
| `secret-store.yaml` | `SecretProviderClass` (CSI secrets-store) mapujący sekrety z Azure Key Vault na sekrety K8s |
| `rbac-role.yaml` | `ClusterRoleBinding` dla tożsamości wdrażającej |
> W wariantach **FluxCD** manifesty aplikacji leżą w `apps/user-microservice/`, a konfiguracja
> klastra w `clusters/prod/`. W pozostałych wariantach manifesty znajdują się w katalogu
> głównym repozytorium.
## Wariant wdrożenia = branch
Każdy scenariusz porównawczy (kombinacja narzędzia CI i CD) ma osobny branch:
| Branch | Scenariusz | CI | CD |
|--------|-----------|----|----|
| `master` | — | — | baza manifestów |
| `jenkins-kubernetes` | 1 | Jenkins | `kubectl apply` (potok deploy w Jenkins) |
| `jenkins-argocd-deploy` | 2 | Jenkins | ArgoCD |
| `jenkins-fluxcd-deploy` | 3 | Jenkins | FluxCD |
| `woodpecker-deploy` | 4 | Woodpecker | `kubectl apply` (potok deploy w Woodpecker) |
| `woodpecker-argocd-deploy` | 5 | Woodpecker | ArgoCD |
| `woodpecker-fluxcd-deploy` | 6 | Woodpecker | FluxCD |
| `argo-deploy` | 7 | Argo Workflows | Argo Workflows |
| `argoworkflow-argocd` | 8 | Argo Workflows | ArgoCD |
| `argoworkflow-fluxcd` / `fluxcd` | 9 | Argo Workflows | FluxCD |
## Narzędzia CD
### kubectl (Jenkins / Woodpecker)
Wariant imperatywny „to samo narzędzie do CI i CD". Potok deploy jest wyzwalany commitem do
tego repozytorium i wykonuje sekwencję:
1. logowanie do Azure (managed identity) i pobranie kubeconfig (`az aks get-credentials`
+ `kubelogin`),
2. `kubectl apply` kolejnych manifestów (`namespace`, `secret-store`, `deploy`, `ingress`),
3. `kubectl rollout status` — oczekiwanie na gotowość podów,
4. **health check** aplikacji przez `curl` na `/health` (do skutku lub timeout).
- **Jenkins** — `.jenkins/Jenkinsfile` (+ `Dockerfile`, `podTemplate.yaml`) na branchu
`jenkins-kubernetes`.
- **Woodpecker** — `.woodpecker/build.yaml` na branchu `woodpecker-deploy`.
### ArgoCD
Model GitOps typu *pull*: ArgoCD obserwuje odpowiedni branch tego repozytorium i synchronizuje
manifesty ze stanem klastra. Manifesty w katalogu głównym repo, wdrożenie wyzwalane commitem
potoku CI (podmiana taga obrazu).
### FluxCD
Model GitOps typu *pull* oparty na CRD Fluksa (katalog `clusters/prod/`):
| Plik | Rola |
|------|------|
| `source.yaml` | `GitRepository` — źródło (ten branch repo), odpytywane co 1 min |
| `kustomization.yaml` | `Kustomization` — ścieżka `./apps/user-microservice`, `prune: true`, docelowy namespace |
| `flux-receiver.yaml` | `Receiver` — webhook przyspieszający reakcję na push (bez czekania na interwał) |
| `source.yaml` / `load-balancer.yaml` / `network-policy.yaml` | Dodatkowa konfiguracja klastra (zależnie od wariantu) |
### Argo Workflows
W scenariuszu 7 (branch `argo-deploy`) rolę CD pełni Argo Workflows: `EventSource` w repo
aplikacji nasłuchuje również na webhook z tego repozytorium (endpoint
`user-microservice-deploy`), co pozwala wyzwolić workflow wdrożeniowy po zmianie manifestów.
## Sekrety i tożsamość
- Sekrety aplikacji (`SQLALCHEMY_DATABASE_URI`, hasła MySQL) nie są przechowywane w repo —
pochodzą z **Azure Key Vault** i są montowane do podów przez sterownik CSI `secrets-store`
(`secret-store.yaml`, `SecretProviderClass` `azure-kvname`).
- Uwierzytelnianie do ACR/AKS/Key Vault odbywa się przez **managed identity** (bez haseł).
- Klucz deploy do Gitea oraz `known_hosts` są dostarczane potokom CI jako sekrety narzędzia
CI (nie znajdują się w repozytorium).
## Powiązanie z repozytorium aplikacji
Kod aplikacji, definicje potoków CI oraz analiza wyników pomiarów znajdują się w repozytorium
[`user-microservice`](../user-microservice) — zobacz jego `README.md` po pełny opis architektury,
scenariuszy pomiarowych i mapy branchy.
+1 -1
View File
@@ -81,7 +81,7 @@ spec:
spec: spec:
containers: containers:
- name: api - name: api
image: marcin00.azurecr.io/user-microservice:a79ae2d50f2fc3dfcf976eb2a8ebe32511ae4a33 image: marcin00.azurecr.io/user-microservice:76a351710fffe2be1ae10471bc1a2f511f481126
ports: ports:
- containerPort: 80 - containerPort: 80
env: env: