ການ​ຈັດ​ຕັ້ງ​ການ​ນໍາ​ໃຊ້​ກັບ​ສະ​ພາບ​ແວດ​ລ້ອມ k8s ຫຼາຍ​ໂດຍ​ການ​ນໍາ​ໃຊ້ helmfile​

Helmfile - wrapper ສໍາລັບ ໝວກ ກັນກະທົບ, ເຊິ່ງອະນຸຍາດໃຫ້ທ່ານອະທິບາຍການປ່ອຍຫມວກກັນກະທົບຈໍານວນຫຼາຍຢູ່ໃນສະຖານທີ່ດຽວ, ກໍານົດຕາຕະລາງຂອງພວກເຂົາສໍາລັບສະພາບແວດລ້ອມຫຼາຍ, ແລະຍັງກໍານົດຄໍາສັ່ງຂອງການປະຕິບັດຂອງພວກເຂົາ.

ທ່ານສາມາດອ່ານກ່ຽວກັບ Helmfile ຕົວຂອງມັນເອງແລະຕົວຢ່າງຂອງການນໍາໃຊ້ຂອງມັນຢູ່ໃນ readme и ຄູ່ມືການປະຕິບັດທີ່ດີທີ່ສຸດ.

ພວກເຮົາຈະຮູ້ຈັກວິທີທີ່ບໍ່ຊັດເຈນເພື່ອອະທິບາຍການປ່ອຍໃນ helmfile

ໃຫ້ເວົ້າວ່າພວກເຮົາມີຊຸດຂອງຕາຕະລາງ helm (ຕົວຢ່າງ, ໃຫ້ເວົ້າວ່າ postgres ແລະບາງຄໍາຮ້ອງສະຫມັກ backend) ແລະສະພາບແວດລ້ອມຈໍານວນຫນຶ່ງ (ຫຼາຍ kubernetes clusters, ຫຼາຍ namespaces, ຫຼືຫຼາຍຂອງທັງສອງ). ພວກເຮົາເອົາ helmfile, ອ່ານເອກະສານ ແລະເລີ່ມອະທິບາຍສະພາບແວດລ້ອມ ແລະການປ່ອຍຕົວຂອງພວກເຮົາ:

    .
    ├── 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

ພວກເຮົາຈົບລົງດ້ວຍ 2 ສະພາບແວດລ້ອມ: ຊາກ, ການ​ຜະ​ລິດ — ແຕ່​ລະ​ຄົນ​ມີ​ຄຸນ​ຄ່າ​ຂອງ​ຕົນ​ເອງ​ສໍາ​ລັບ​ຕາ​ຕະ​ລາງ​ການ​ປ່ອຍ​ຫມວກ​. ພວກເຮົາຈະນໍາໃຊ້ໃຫ້ເຂົາເຈົ້າເຊັ່ນນີ້:

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 }}
...

ຊຸດຄໍາຮ້ອງສະຫມັກທີ່ແຕກຕ່າງກັນໃນສະພາບແວດລ້ອມທີ່ແຕກຕ່າງກັນ

ດີຫຼາຍ, ແຕ່ຖ້າພວກເຮົາບໍ່ຕ້ອງການ production roll out postgres, ເພາະວ່າພວກເຮົາຮູ້ວ່າພວກເຮົາບໍ່ຈໍາເປັນຕ້ອງຍູ້ຖານຂໍ້ມູນເຂົ້າໄປໃນ k8s ແລະສໍາລັບການຂາຍພວກເຮົາມີກຸ່ມ postgres ແຍກຕ່າງຫາກທີ່ປະເສີດບໍ? ເພື່ອແກ້ໄຂບັນຫານີ້, ພວກເຮົາມີປ້າຍຊື່

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

ນີ້ແມ່ນດີຫຼາຍ, ແຕ່ສ່ວນຕົວຂ້ອຍມັກອະທິບາຍວ່າແອັບພລິເຄຊັນໃດທີ່ຈະໃຊ້ໃນສະພາບແວດລ້ອມທີ່ບໍ່ໃຊ້ການໂຕ້ຖຽງການເປີດຕົວ, ແຕ່ໃນຄໍາອະທິບາຍຂອງສະພາບແວດລ້ອມເອງ. ຈະເຮັດແນວໃດ? ທ່ານ​ສາ​ມາດ​ວາງ​ຄໍາ​ອະ​ທິ​ບາຍ​ການ​ປ່ອຍ​ໃນ​ໂຟນ​ເດີ​ແຍກ​ຕ່າງ​ຫາກ​, ສ້າງ​ບັນ​ຊີ​ລາຍ​ການ​ຂອງ​ການ​ປ່ອຍ​ທີ່​ຈໍາ​ເປັນ​ໃນ​ການ​ອະ​ທິ​ບາຍ​ສະ​ພາບ​ແວດ​ລ້ອມ​ແລະ "ເອົາ​" ພຽງ​ແຕ່​ການ​ປ່ອຍ​ທີ່​ຈໍາ​ເປັນ​, ບໍ່​ສົນ​ກັບ​ສ່ວນ​ທີ່​ເຫຼືອ​.

    .
    ├── 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 ---, ດັ່ງ​ນັ້ນ​ທ່ານ​ສາ​ມາດ​ເຮັດ​ໃຫ້ template ປ່ອຍ (ແລະ​ພາກ​ສ່ວນ​ອື່ນໆ​, ເຊັ່ນ​: helmDefaults​) ທີ່​ມີ​ຄຸນ​ຄ່າ​ຈາກ​ສະ​ພາບ​ແວດ​ລ້ອມ

ໃນກໍລະນີນີ້, ການປ່ອຍ postgres ຈະບໍ່ຖືກລວມເຂົ້າໃນຄໍາອະທິບາຍສໍາລັບການຜະລິດ. ສະດວກສະບາຍຫຼາຍ!

Overridable ມູນຄ່າທົ່ວໂລກສໍາລັບການປ່ອຍ

ແນ່ນອນ, ມັນເປັນການດີທີ່ທ່ານສາມາດກໍານົດຄ່າສໍາລັບຕາຕະລາງຫມວກກັນກະທົບສໍາລັບແຕ່ລະສະພາບແວດລ້ອມ, ແຕ່ຈະເປັນແນວໃດຖ້າພວກເຮົາມີສະພາບແວດລ້ອມຈໍານວນຫນຶ່ງທີ່ອະທິບາຍ, ແລະພວກເຮົາຕ້ອງການ, ສໍາລັບຕົວຢ່າງ, ກໍານົດດຽວກັນສໍາລັບທຸກຄົນ. affinity, ແຕ່ພວກເຮົາບໍ່ຕ້ອງການກໍານົດມັນໂດຍຄ່າເລີ່ມຕົ້ນໃນຕາຕະລາງດ້ວຍຕົນເອງ, ເຊິ່ງຖືກເກັບໄວ້ໃນ turnips.

ໃນ​ກໍ​ລະ​ນີ​ນີ້​, ສໍາ​ລັບ​ການ​ປ່ອຍ​ແຕ່​ລະ​ຄົນ​ພວກ​ເຮົາ​ສາ​ມາດ​ກໍາ​ນົດ 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"

ການກໍານົດມູນຄ່າທົ່ວໂລກສໍາລັບຕາຕະລາງ helm ຂອງການປ່ອຍທັງຫມົດໃນລະດັບສະພາບແວດລ້ອມ

ສົມມຸດວ່າພວກເຮົາສ້າງ ingress ຫຼາຍໆຄັ້ງໃນຫຼາຍລຸ້ນ - ພວກເຮົາສາມາດກໍານົດດ້ວຍຕົນເອງສໍາລັບແຕ່ລະຕາຕະລາງ hosts:, ແຕ່ໃນກໍລະນີຂອງພວກເຮົາໂດເມນແມ່ນຄືກັນ, ດັ່ງນັ້ນເປັນຫຍັງຈຶ່ງບໍ່ເອົາມັນຢູ່ໃນບາງຕົວແປທົ່ວໂລກແລະພຽງແຕ່ທົດແທນມູນຄ່າຂອງມັນເຂົ້າໃນຕາຕະລາງ? ເພື່ອເຮັດສິ່ງນີ້, ໄຟລ໌ເຫຼົ່ານັ້ນທີ່ມີຄ່າທີ່ພວກເຮົາຕ້ອງການ parameterize ຈະຕ້ອງມີການຂະຫຍາຍ .gotmpl, ດັ່ງນັ້ນ helmfile ຮູ້ວ່າມັນຈໍາເປັນຕ້ອງດໍາເນີນການຜ່ານເຄື່ອງຈັກແມ່ແບບ.

    .
    ├── 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 }}

ບັນທຶກ

ແນ່ນອນ, ingress ໃນຕາຕະລາງ postgres ແມ່ນບາງສິ່ງບາງຢ່າງທີ່ຫນ້າສົງໄສທີ່ສຸດ, ດັ່ງນັ້ນບົດຄວາມນີ້ແມ່ນໃຫ້ພຽງແຕ່ເປັນຕົວຢ່າງ spherical ໃນສູນຍາກາດແລະເພື່ອບໍ່ໃຫ້ແນະນໍາການປ່ອຍໃຫມ່ໃນບົດຄວາມພຽງແຕ່ສໍາລັບ sake ຂອງການອະທິບາຍ ingress.

ການທົດແທນຄວາມລັບຈາກຄຸນຄ່າສິ່ງແວດລ້ອມ

ໂດຍການປຽບທຽບກັບຕົວຢ່າງຂ້າງເທິງ, ທ່ານສາມາດທົດແທນການເຂົ້າລະຫັດໂດຍໃຊ້ ຄວາມລັບຂອງຫມວກກັນກະທົບ ຄວາມ​ຫມາຍ. ແທນທີ່ຈະສ້າງໄຟລ໌ຄວາມລັບຂອງພວກເຮົາເອງສໍາລັບແຕ່ລະການປ່ອຍ, ໃນທີ່ພວກເຮົາສາມາດກໍານົດຄ່າ encrypted ສໍາລັບຕາຕະລາງ, ພວກເຮົາສາມາດກໍານົດພຽງແຕ່ໃນການປ່ອຍ 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 - ຫນ້າທີ່ພິເສດສໍາລັບ go templates ໃນ helmfile, ເຊິ່ງ, ເຖິງແມ່ນວ່າ .Values.secrets ຈະບໍ່ຢູ່, ຈະບໍ່ຖິ້ມຄວາມຜິດພາດ, ແຕ່ຈະອະນຸຍາດໃຫ້ຜົນໄດ້ຮັບໂດຍໃຊ້ຟັງຊັນ default ແທນຄ່າເລີ່ມຕົ້ນ

ສະຫລຸບ

ສິ່ງທີ່ໄດ້ອະທິບາຍເບິ່ງຄືວ່າຈະແຈ້ງ, ແຕ່ຂໍ້ມູນກ່ຽວກັບການອະທິບາຍທີ່ສະດວກໃນການປະຕິບັດຕໍ່ສະພາບແວດລ້ອມຫຼາຍໆຢ່າງໂດຍໃຊ້ helmfile ແມ່ນຂາດແຄນຫຼາຍ, ແລະຂ້ອຍຮັກ IaC (Infrastructure-as-Code) ແລະຕ້ອງການໃຫ້ຄໍາອະທິບາຍທີ່ຊັດເຈນກ່ຽວກັບສະຖານະຂອງການນໍາໃຊ້.

ສະຫລຸບລວມແລ້ວ, ຂ້າພະເຈົ້າຢາກຈະເພີ່ມວ່າຕົວແປສໍາລັບສະພາບແວດລ້ອມເລີ່ມຕົ້ນສາມາດ, ໃນທາງກັບກັນ, ຕົວກໍານົດການກັບຕົວແປສະພາບແວດລ້ອມຂອງ OS ຂອງ runner ທີ່ແນ່ນອນຈາກການປະຕິບັດຈະຖືກເປີດຕົວ, ແລະດັ່ງນັ້ນຈຶ່ງໄດ້ຮັບສະພາບແວດລ້ອມແບບເຄື່ອນໄຫວ.

helmfile.yaml

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

ແຫຼ່ງຂໍ້ມູນ: www.habr.com