હેલ્મફાઈલનો ઉપયોગ કરીને બહુવિધ k8s પર્યાવરણોમાં જમાવટનું આયોજન કરવું

હેલ્મફાઈલ - માટે રેપર સુકાન, જે તમને એક જગ્યાએ ઘણા હેલ્મ રીલીઝનું વર્ણન કરવા, વિવિધ વાતાવરણ માટે તેમના ચાર્ટને પેરામીટરાઇઝ કરવા અને તેમના જમાવટનો ક્રમ પણ સેટ કરવાની પરવાનગી આપે છે.

તમે હેલ્મફાઇલ વિશે અને તેના ઉપયોગના ઉદાહરણો વિશે વાંચી શકો છો રીડમી и શ્રેષ્ઠ વ્યવહાર માર્ગદર્શિકા.

અમે હેલ્મફાઈલમાં પ્રકાશનોનું વર્ણન કરવાની બિન-સ્પષ્ટ રીતોથી પરિચિત થઈશું

ચાલો કહીએ કે અમારી પાસે હેલ્મ ચાર્ટ્સનું એક પેક છે (ઉદાહરણ તરીકે, ચાલો પોસ્ટગ્રેસ અને કેટલાક બેકએન્ડ એપ્લિકેશન કહીએ) અને કેટલાક વાતાવરણ (કેટલાક કુબરનેટ્સ ક્લસ્ટરો, ઘણી નેમસ્પેસ અથવા બંનેમાંથી ઘણી) છે. અમે હેલ્મફાઈલ લઈએ છીએ, દસ્તાવેજો વાંચીએ છીએ અને અમારા વાતાવરણ અને પ્રકાશનોનું વર્ણન કરવાનું શરૂ કરીએ છીએ:

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

વિવિધ વાતાવરણમાં સુકાન ચાર્ટની વિવિધ આવૃત્તિઓ

જો આપણે બેકએન્ડના વિવિધ સંસ્કરણોને વિવિધ વાતાવરણમાં રોલ આઉટ કરવાની જરૂર હોય તો શું? પ્રકાશન સંસ્કરણનું પરિમાણ કેવી રીતે કરવું? દ્વારા ઉપલબ્ધ પર્યાવરણીય મૂલ્યો {{ .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 પોસ્ટગ્રેસને રોલ આઉટ કરો, કારણ કે આપણે જાણીએ છીએ કે અમારે ડેટાબેઝને k8s માં દબાણ કરવાની જરૂર નથી અને વેચાણ માટે અમારી પાસે એક અદ્ભુત અલગ પોસ્ટગ્રેસ ક્લસ્ટર છે? આ સમસ્યાને ઉકેલવા માટે અમારી પાસે લેબલ્સ છે

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 વિભાજકનો ઉપયોગ કરવો જરૂરી છે ---, જેથી તમે પર્યાવરણમાંથી મૂલ્યો સાથે પ્રકાશનો (અને અન્ય ભાગો, જેમ કે હેલ્મડિફોલ્ટ્સ) ટેમ્પલેટ કરી શકો

આ કિસ્સામાં, પોસ્ટગ્રેસ પ્રકાશન ઉત્પાદન માટેના વર્ણનમાં પણ શામેલ કરવામાં આવશે નહીં. ખૂબ જ આરામથી!

પ્રકાશનો માટે ઓવરરાઇડેબલ વૈશ્વિક મૂલ્યો

અલબત્ત, તે સરસ છે કે તમે દરેક પર્યાવરણ માટે સુકાન ચાર્ટ માટે મૂલ્યો સેટ કરી શકો છો, પરંતુ જો આપણી પાસે ઘણા વાતાવરણ વર્ણવવામાં આવ્યા હોય, અને અમે ઇચ્છીએ છીએ કે, ઉદાહરણ તરીકે, બધા માટે સમાન સેટ કરવું 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"

પર્યાવરણ સ્તરે તમામ પ્રકાશનોના સુકાન ચાર્ટ માટે વૈશ્વિક મૂલ્યોની વ્યાખ્યા કરવી

ચાલો કહીએ કે અમે અનેક પ્રકાશનોમાં અનેક પ્રવેશ બનાવીએ છીએ - અમે દરેક ચાર્ટ માટે મેન્યુઅલી વ્યાખ્યાયિત કરી શકીએ છીએ hosts:, પરંતુ અમારા કિસ્સામાં ડોમેન એક જ છે, તો શા માટે તેને કેટલાક વૈશ્વિક ચલમાં ન મૂકશો અને તેના મૂલ્યને ચાર્ટમાં બદલી દો? આ કરવા માટે, મૂલ્યોવાળી તે ફાઇલો કે જેને આપણે પરિમાણિત કરવા માંગીએ છીએ તેમાં એક્સ્ટેંશન હોવું જરૂરી છે .gotmpl, જેથી હેલ્મફાઈલ જાણે છે કે તેને ટેમ્પલેટ એન્જિન દ્વારા ચલાવવાની જરૂર છે.

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

નોંધ

દેખીતી રીતે, પોસ્ટગ્રેસ ચાર્ટમાં પ્રવેશ એ ખૂબ જ શંકાસ્પદ બાબત છે, તેથી આ લેખ ખાલી શૂન્યાવકાશમાં ગોળાકાર ઉદાહરણ તરીકે આપવામાં આવ્યો છે અને ફક્ત પ્રવેશનું વર્ણન કરવા ખાતર લેખમાં કેટલીક નવી રજૂઆત દાખલ ન કરવા માટે.

પર્યાવરણીય મૂલ્યોમાંથી રહસ્યોને સ્થાનાંતરિત કરવું

ઉપરોક્ત ઉદાહરણ સાથે સામ્યતા દ્વારા, તમે એન્ક્રિપ્ટેડનો ઉપયોગ કરીને બદલી શકો છો સુકાન રહસ્યો અર્થો દરેક પ્રકાશન માટે આપણી પોતાની સિક્રેટ ફાઇલ બનાવવાને બદલે, જેમાં આપણે ચાર્ટ માટે એનક્રિપ્ટેડ મૂલ્યો વ્યાખ્યાયિત કરી શકીએ છીએ, અમે ફક્ત રીલીઝ 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 - હેલ્મફાઈલમાં ગો ટેમ્પલેટ્સ માટે એક વિશેષ કાર્ય, જે, ભલે .Values.secrets અસ્તિત્વમાં રહેશે નહીં, ભૂલ ફેંકશે નહીં, પરંતુ ફંક્શનનો ઉપયોગ કરીને પરિણામની મંજૂરી આપશે default અવેજી ડિફૉલ્ટ મૂલ્ય

નિષ્કર્ષ

વર્ણવેલ વસ્તુઓ એકદમ સ્પષ્ટ લાગે છે, પરંતુ હેલ્મફાઈલનો ઉપયોગ કરીને કેટલાક પર્યાવરણોમાં જમાવટના અનુકૂળ વર્ણન પરની માહિતી ખૂબ જ દુર્લભ છે, અને મને IaC (ઇન્ફ્રાસ્ટ્રક્ચર-એ-કોડ) ગમે છે અને ડિપ્લોયમેન્ટ સ્ટેટનું સ્પષ્ટ વર્ણન કરવા માંગું છું.

નિષ્કર્ષમાં, હું ઉમેરવા માંગુ છું કે ડિફૉલ્ટ એન્વાયર્નમેન્ટ માટેના વેરીએબલ્સ, બદલામાં, ચોક્કસ રનરના OSના પર્યાવરણ ચલો સાથે પરિમાણિત થઈ શકે છે કે જ્યાંથી જમાવટ શરૂ કરવામાં આવશે, અને આ રીતે ગતિશીલ વાતાવરણ પ્રાપ્ત કરી શકાય છે.

helmfile.yaml

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

સોર્સ: www.habr.com