helmfile ကို အသုံးပြု၍ k8s များစွာသော ပတ်ဝန်းကျင်များသို့ ဖြန့်ကျက်စုစည်းခြင်း။

Helmfile - ထုပ်ပိုးဘို့ စခန်းတစ်နေရာတည်းတွင် ပဲ့ပိုင်းထုတ်လွှတ်မှုများစွာကို ဖော်ပြရန်၊ ၎င်းတို့၏ ဇယားကွက်များကို ပတ်ဝန်းကျင်အများအပြားအတွက် ကန့်သတ်သတ်မှတ်ပေးပြီး ၎င်းတို့၏ ဖြန့်ကျက်မှုအစီအစဥ်ကိုလည်း သတ်မှတ်နိုင်စေသည့်၊

helmfile ကိုယ်တိုင်အကြောင်းနှင့်၎င်း၏အသုံးပြုမှုနမူနာများကိုဖတ်နိုင်သည်။ readme и အကောင်းဆုံးအလေ့အကျင့်လမ်းညွှန်.

helmfile တွင် ထုတ်ဝေမှုများကို ဖော်ပြရန် ရှင်းရှင်းလင်းလင်းမဟုတ်သော နည်းလမ်းများကို ကျွန်ုပ်တို့ သိလာပါမည်။

ကျွန်ုပ်တို့တွင် ပဲ့ထိန်းဇယားများ အစုံပါရှိသည် (ဥပမာ၊ postgres နှင့် backend အပလီကေးရှင်းအချို့ကိုဆိုပါစို့) နှင့် ပတ်ဝန်းကျင်များစွာ ( kubernetes အစုအဝေးများစွာ၊ namespaces များစွာ သို့မဟုတ် နှစ်ခုလုံး၏ အများအပြား)။ ကျွန်ုပ်တို့သည် ဖိုင်ကိုယူ၍ စာရွက်စာတမ်းကိုဖတ်ပြီး ကျွန်ုပ်တို့၏ပတ်ဝန်းကျင်နှင့် ထုတ်ဝေမှုများကို စတင်ဖော်ပြရန်-

    .
    ├── envs
    │   ├── devel
    │   │   └── values
    │   │       ├── backend.yaml
    │   │       └── postgres.yaml
    │   └── production
    │       └── values
    │           ├── backend.yaml
    │           └── postgres.yaml
    └── helmfile.yaml

helmfile.yaml

environments:
  devel:
  production:

releases:
  - name: postgres
    labels:
      app: postgres
    wait: true
    chart: stable/postgresql
    version: 8.4.0
    values:
      - envs/{{ .Environment.Name }}/values/postgres.yaml
  - name: backend
    labels:
      app: backend
    wait: true
    chart: private-helm-repo/backend
    version: 1.0.5
    needs:
      - postgres
    values:
      - envs/{{ .Environment.Name }}/values/backend.yaml

ကျွန်ုပ်တို့သည် ပတ်ဝန်းကျင် ၂ ခုဖြင့် အဆုံးသတ်ခဲ့သည် ကဗျာ, ထုတ်လုပ်မှု — တစ်ခုစီတွင် ပဲ့ထုတ်ခြင်းဇယားများအတွက် ၎င်း၏ကိုယ်ပိုင်တန်ဖိုးများ ပါရှိသည်။ ၎င်းတို့အား ဤကဲ့သို့ အသုံးချပါမည်-

helmfile -n <namespace> -e <env> apply

မတူညီသောပတ်ဝန်းကျင်များတွင် ပဲ့ချိတ်ဇယားများ၏ ဗားရှင်းအမျိုးမျိုး

Backend ၏ မတူညီသော ဗားရှင်းများကို မတူညီသော ပတ်၀န်းကျင်များသို့ ဖြန့်ချိရန် လိုအပ်ပါက၊ ဖြန့်ချိသည့်ဗားရှင်းကို မည်သို့ကန့်သတ်မည်နည်း။ ပတ်ဝန်းကျင် ကတဆင့် တန်ဖိုးထားမှုတွေ ရရှိနိုင်ပါတယ်။ {{ .Values }}

helmfile.yaml

environments:
  devel:
+   values:
+   - charts:
+       versions:
+         backend: 1.1.0
  production:
+   values:
+   - charts:
+       versions:
+         backend: 1.0.5
...
  - name: backend
    labels:
      app: backend
    wait: true
    chart: private-helm-repo/backend
-   version: 1.0.5
+   version: {{ .Values.charts.versions.backend }}
...

မတူညီသောပတ်ဝန်းကျင်များတွင် မတူညီသော application အစုံ

ကောင်းတယ် ဒါပေမယ့် မလိုအပ်ရင် ဘယ်လိုလုပ်မလဲ။ production ကျွန်ုပ်တို့သည် ဒေတာဘေ့စ်ကို k8s သို့ တွန်းပို့ရန် မလိုအပ်ကြောင်း ကျွန်ုပ်တို့သိသောကြောင့် postgres များကို ဖြန့်ထုတ်ပြီး ရောင်းချရန်အတွက် ကျွန်ုပ်တို့တွင် အံ့သြဖွယ်သီးခြား postgres အစုအဝေးတစ်ခုရှိနေသည်။ ဤပြဿနာကိုဖြေရှင်းရန် ကျွန်ုပ်တို့တွင် တံဆိပ်များရှိသည်။

helmfile -n <namespace> -e devel apply
helmfile -n <namespace> -e production -l app=backend apply

၎င်းသည် ကောင်းမွန်သော်လည်း၊ launch arguments များကိုမသုံးဘဲ ပတ်ဝန်းကျင်တွင် အသုံးချရမည့် application များကို ကိုယ်တိုင်ကိုယ်ကျ ဖော်ပြလိုပါသည်။ ဘာလုပ်မလဲ? ထုတ်ဝေမှုဖော်ပြချက်များအား သီးခြားဖိုင်တွဲတစ်ခုတွင် ထားနိုင်ပြီး၊ ပတ်ဝန်းကျင်ဖော်ပြချက်တွင် လိုအပ်သောထုတ်ပြန်ချက်များစာရင်းကို ဖန်တီးနိုင်ပြီး ကျန်အရာများကို လျစ်လျူရှုကာ လိုအပ်သောထုတ်ဝေမှုများကိုသာ "ကောက်ယူ" နိုင်ပါသည်။

    .
    ├── envs
    │   ├── devel
    │   │   └── values
    │   │       ├── backend.yaml
    │   │       └── postgres.yaml
    │   └── production
    │       └── values
    │           ├── backend.yaml
    │           └── postgres.yaml
+   ├── releases
+   │   ├── backend.yaml
+   │   └── postgres.yaml
    └── helmfile.yaml

helmfile.yaml

  environments:
    devel:
      values:
      - charts:
          versions:
            backend: 1.1.0
      - apps:
        - postgres
        - backend

    production:
      values:
      - charts:
          versions:
            backend: 1.0.5
      - apps:
        - backend

- releases:
-    - name: postgres
-      labels:
-        app: postgres
-      wait: true
-      chart: stable/postgresql
-      version: 8.4.0
-      values:
-        - envs/{{ .Environment.Name }}/values/postgres.yaml
-    - name: backend
-      labels:
-        app: backend
-      wait: true
-      chart: private-helm-repo/backend
-     version: {{ .Values.charts.versions.backend }}
-     needs:
-       - postgres
-     values:
-       - envs/{{ .Environment.Name }}/values/backend.yaml
+ ---
+ bases:
+ {{- range .Values.apps }}
+   - releases/{{ . }}.yaml
+ {{- end }}

releases/postgres.yaml

releases:
  - name: postgres
    labels:
      app: postgres
    wait: true
    chart: stable/postgresql
    version: 8.4.0
    values:
      - envs/{{ .Environment.Name }}/values/postgres.yaml

releases/backend.yaml

releases:
  - name: backend
    labels:
      app: backend
    wait: true
    chart: private-helm-repo/backend
    version: {{ .Values.charts.versions.backend }}
    needs:
      - postgres
    values:
      - envs/{{ .Environment.Name }}/values/backend.yaml

မှတ်ချက်

အသုံးပြုခြင်း bases: yaml separator ကိုအသုံးပြုရန်လိုအပ်သည်။ ---ထို့ကြောင့် သင်သည် ပတ်ဝန်းကျင်မှ တန်ဖိုးများ (helmDefaults ကဲ့သို့သော အခြားအစိတ်အပိုင်းများ) ထုတ်ဝေမှုများကို နမူနာပုံစံ ပြုလုပ်နိုင်စေရန်၊

ဤကိစ္စတွင်၊ Postgres ထုတ်ဝေမှုသည် ထုတ်လုပ်မှုအတွက် ဖော်ပြချက်တွင်ပင် ထည့်သွင်းမည်မဟုတ်ပါ။ အရမ်းအဆင်ပြေတယ်!

ထုတ်ဝေမှုများအတွက် လွှမ်းမိုးနိုင်သော ကမ္ဘာလုံးဆိုင်ရာတန်ဖိုးများ

ပတ်ဝန်းကျင်တစ်ခုစီအတွက် ပဲ့စင်ဇယားများအတွက် တန်ဖိုးများကို သင်သတ်မှတ်နိုင်သည်မှာ ကောင်းပါတယ်၊ သို့သော် ကျွန်ုပ်တို့တွင် ပတ်ဝန်းကျင်များစွာကို ဖော်ပြထားပြီး၊ ဥပမာအားဖြင့်၊ အားလုံးအတွက် တူညီပါက၊ affinityသို့သော်၊ ကျွန်ုပ်တို့သည် ၎င်းကို မုန်လာဥတွင် သိမ်းဆည်းထားသည့် ဇယားများတွင် ၎င်းတို့ကိုယ်တိုင် ပုံသေပုံစံဖြင့် မဖွဲ့စည်းလိုပါ။

ဤကိစ္စတွင်၊ ထုတ်ဝေမှုတစ်ခုစီအတွက် ကျွန်ုပ်တို့သည် တန်ဖိုးများနှင့်အတူ ဖိုင် 2 ခုကို သတ်မှတ်နိုင်သည်- ပထမတစ်ခုသည် ပုံသေတန်ဖိုးများဖြစ်ပြီး၊ ၎င်းသည် ဇယား၏တန်ဖိုးများကို ကိုယ်တိုင်ဆုံးဖြတ်ပေးမည့်၊ ဒုတိယတစ်ခုသည် ပတ်ဝန်းကျင်အတွက် တန်ဖိုးများပါရှိသည့်၊ ပုံသေ။

    .
    ├── envs
+   │   ├── default
+   │   │   └── values
+   │   │       ├── backend.yaml
+   │   │       └── postgres.yaml
    │   ├── devel
    │   │   └── values
    │   │       ├── backend.yaml
    │   │       └── postgres.yaml
    │   └── production
    │       └── values
    │           ├── backend.yaml
    │           └── postgres.yaml
    ├── releases
    │   ├── backend.yaml
    │   └── postgres.yaml
    └── helmfile.yaml

releases/backend.yaml

releases:
  - name: backend
    labels:
      app: backend
    wait: true
    chart: private-helm-repo/backend
    version: {{ .Values.charts.versions.backend }}
    needs:
      - postgres
    values:
+     - envs/default/values/backend.yaml
      - envs/{{ .Environment.Name }}/values/backend.yaml

envs/default/values/backend.yaml

affinity:
  podAntiAffinity:
    preferredDuringSchedulingIgnoredDuringExecution:
    - weight: 1
      podAffinityTerm:
        labelSelector:
          matchExpressions:
          - key: app.kubernetes.io/name
            operator: In
            values:
            - backend
        topologyKey: "kubernetes.io/hostname"

ပတ်ဝန်းကျင်အဆင့်ရှိ ထုတ်ဝေမှုအားလုံး၏ ပဲ့ကိုင်ဇယားများအတွက် ကမ္ဘာလုံးဆိုင်ရာတန်ဖိုးများကို သတ်မှတ်ခြင်း။

ကျွန်ုပ်တို့သည် ထုတ်ဝေမှုများစွာတွင် ingress အများအပြားကို ဖန်တီးသည်ဆိုပါစို့ - ကျွန်ုပ်တို့သည် ဇယားတစ်ခုစီအတွက် ကိုယ်တိုင်သတ်မှတ်နိုင်သည်။ hosts:သို့သော် ကျွန်ုပ်တို့၏အခြေအနေတွင် ဒိုမိန်းသည် အတူတူဖြစ်သည်၊ ထို့ကြောင့် ၎င်းကို global variable တွင်ထည့်ကာ ၎င်း၏တန်ဖိုးကို ဇယားများတွင် ရိုးရိုးရှင်းရှင်း အစားထိုးပါ။ ဒါကိုလုပ်ဖို့၊ ကျွန်တော်တို့ parameterize လုပ်ချင်တဲ့ တန်ဖိုးတွေနဲ့ အဲဒီဖိုင်တွေမှာ extension ရှိရမယ်။ .gotmpl၊ ထို့ကြောင့် helmfile သည် template engine မှတဆင့် run ရန်လိုအပ်ကြောင်းသိသည်။

    .
    ├── envs
    │   ├── default
    │   │   └── values
-   │   │       ├── backend.yaml
-   │   │       ├── postgres.yaml
+   │   │       ├── backend.yaml.gotmpl
+   │   │       └── postgres.yaml.gotmpl
    │   ├── devel
    │   │   └── values
    │   │       ├── backend.yaml
    │   │       └── postgres.yaml
    │   └── production
    │       └── values
    │           ├── backend.yaml
    │           └── postgres.yaml
    ├── releases
    │   ├── backend.yaml
    │   └── postgres.yaml
    └── helmfile.yaml

helmfile.yaml

  environments:
    devel:
      values:
      - charts:
          versions:
            backend: 1.1.0
      - apps:
        - postgres
        - backend
+     - global:
+         ingressDomain: k8s.devel.domain

    production:
      values:
      - charts:
          versions:
            backend: 1.0.5
      - apps:
        - backend
+     - global:
+         ingressDomain: production.domain
  ---
  bases:
  {{- range .Values.apps }}
    - releases/{{ . }}.yaml
  {{- end }}

envs/default/values/backend.yaml.gotmpl

ingress:
  enabled: true
  paths:
    - /api
  hosts:
    - {{ .Values.global.ingressDomain }}

envs/default/values/postgres.yaml.gotmpl

ingress:
  enabled: true
  paths:
    - /
  hosts:
    - postgres.{{ .Values.global.ingressDomain }}

မှတ်ချက်

ထင်ရှားသည်မှာ၊ postgres ဇယားရှိ ingress သည် အလွန်သံသယဖြစ်ဖွယ်အရာဖြစ်သည်၊ ထို့ကြောင့် ဤဆောင်းပါးကို လေဟာနယ်တစ်ခုတွင် လုံးပတ်နမူနာတစ်ခုအဖြစ် ရိုးရှင်းစွာပေးထားပြီး ingress ကိုဖော်ပြရန်အတွက်သာ ဆောင်းပါးတွင် အသစ်ထွက်ရှိလာခြင်းကို မိတ်ဆက်ခြင်းမပြုနိုင်ရန်၊

ပတ်ဝန်းကျင်တန်ဖိုးများမှ လျှို့ဝှက်ချက်များကို အစားထိုးခြင်း။

အထက်ဖော်ပြပါ ဥပမာနှင့် နှိုင်းယှဉ်ခြင်းဖြင့်၊ သင်သည် ကုဒ်ဝှက်ထားသော အရာများကို အစားထိုးနိုင်သည်။ ပဲ့စင်လျှို့ဝှက်ချက်များ အဓိပ္ပါယ်များ ထုတ်ဝေမှုတစ်ခုစီအတွက် ကျွန်ုပ်တို့၏ကိုယ်ပိုင်လျှို့ဝှက်ချက်ဖိုင်ကို ဖန်တီးရာ၌၊ ကျွန်ုပ်တို့သည် ဇယားအတွက် ကုဒ်ဝှက်ထားသောတန်ဖိုးများကို သတ်မှတ်နိုင်စေမည့်အစား၊ ကျွန်ုပ်တို့သည် ထုတ်ဝေမှု default.yaml.gotmpl တွင် သတ်မှတ်ထားသော ကိန်းရှင်များမှ ထုတ်ယူရမည့် တန်ဖိုးများကို ရိုးရိုးရှင်းရှင်းသတ်မှတ်နိုင်သည်။ ပတ်ဝန်းကျင်အဆင့်။ ထို့အပြင် ကျွန်ုပ်တို့သည် မည်သူတစ်ဦးတစ်ယောက်ထံမှ ဝှက်ထားရန် မလိုအပ်သော တန်ဖိုးများကို သီးခြားပတ်ဝန်းကျင်ရှိ ထုတ်ဝေမှုတန်ဖိုးများတွင် အလွယ်တကူ ပြန်လည်သတ်မှတ်နိုင်သည်။

    .
    ├── envs
    │   ├── default
    │   │   └── values
    │   │       ├── backend.yaml
    │   │       └── postgres.yaml
    │   ├── devel
    │   │   ├── values
    │   │   │   ├── backend.yaml
    │   │   │   └── postgres.yaml
+   │   │   └── secrets.yaml
    │   └── production
    │       ├── values
    │       │   ├── backend.yaml
    │       │   └── postgres.yaml
+   │       └── secrets.yaml
    ├── releases
    │   ├── backend.yaml
    │   └── postgres.yaml
    └── helmfile.yaml

helmfile.yaml

  environments:
    devel:
      values:
      - charts:
          versions:
            backend: 1.1.0
      - apps:
        - postgres
        - backend
      - global:
          ingressDomain: k8s.devel.domain
+     secrets:
+       - envs/devel/secrets.yaml

    production:
      values:
      - charts:
          versions:
            backend: 1.0.5
      - apps:
        - backend
      - global:
          ingressDomain: production.domain
+     secrets:
+       - envs/production/secrets.yaml
  ---
  bases:
  {{- range .Values.apps }}
    - releases/{{ . }}.yaml
  {{- end }}

envs/devel/secrets.yaml

secrets:
    elastic:
        password: ENC[AES256_GCM,data:hjCB,iv:Z1P6/6xBJgJoKLJ0UUVfqZ80o4L84jvZfM+uH9gBelc=,tag:dGqQlCZnLdRAGoJSj63rBQ==,type:int]
...

envs/production/secrets.yaml

secrets:
    elastic:
        password: ENC[AES256_GCM,data:ZB/VpTFk8f0=,iv:EA//oT1Cb5wNFigTDOz3nA80qD9UwTjK5cpUwLnEXjs=,tag:hMdIUaqLRA8zuFBd82bz6A==,type:str]
...

envs/default/values/backend.yaml.gotmpl

elasticsearch:
  host: elasticsearch
  port: 9200
  password: {{ .Values | getOrNil "secrets.elastic.password" | default "password" }}

envs/devel/values/backend.yaml

elasticsearch:
  host: elastic-0.devel.domain

envs/production/values/backend.yaml

elasticsearch:
  host: elastic-0.production.domain

မှတ်ချက်

စကားမစပ်, getOrNil - အကယ်၍ helmfile ရှိ go templates အတွက် အထူးလုပ်ဆောင်ချက်တစ်ခု .Values.secrets ရှိမည်မဟုတ်ပါ၊ အမှားကိုပစ်မည်မဟုတ်သော်လည်း function ကိုအသုံးပြုခြင်းဖြင့်ရလဒ်ကိုခွင့်ပြုလိမ့်မည်။ default မူရင်းတန်ဖိုးကို အစားထိုးပါ။

ကောက်ချက်

ဖော်ပြထားသည့်အရာများသည် ရှင်းရှင်းလင်းလင်းထင်ရသော်လည်း helmfile ကိုအသုံးပြု၍ ပတ်ဝန်းကျင်အများအပြားသို့ ဖြန့်ကျက်ခြင်းအတွက် အဆင်ပြေသောဖော်ပြချက်ပါ အချက်အလက်များသည် အလွန်ရှားပါးပြီး IaC (Infrastructure-as-Code) ကိုနှစ်သက်ပြီး ဖြန့်ကျက်မှုအခြေအနေအား ရှင်းလင်းစွာဖော်ပြလိုပါသည်။

နိဂုံးချုပ်အနေနဲ့၊ မူရင်းပတ်ဝန်းကျင်အတွက် variable တွေကို deployment စတင်မယ့် runner ရဲ့ OS ရဲ့ environment variables တွေနဲ့ parameterized လုပ်နိုင်ပြီး dynamic environments တွေကို ရယူနိုင်ဖို့ နိဂုံးချုပ်ချင်ပါတယ်။

helmfile.yaml

environments:
  default:
    values:
    - global:
        clusterDomain: {{ env "CLUSTER_DOMAIN" | default "cluster.local" }}
        ingressDomain: {{ env "INGRESS_DOMAIN" }}

source: www.habr.com