हेल्मफाइल प्रयोग गरेर धेरै 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 विभाजक प्रयोग गर्न आवश्यक छ ---, ताकि तपाईं वातावरणबाट मानहरू सहित रिलिजहरू (र अन्य भागहरू, जस्तै helmDefaults) टेम्प्लेट गर्न सक्नुहुन्छ।

यस अवस्थामा, पोस्टग्रेस रिलीज पनि उत्पादनको लागि विवरणमा समावेश गरिने छैन। धेरै सहज!

विमोचनका लागि ओभरराइड गर्न मिल्ने विश्वव्यापी मानहरू

निस्सन्देह, यो राम्रो छ कि तपाईंले प्रत्येक वातावरणको लागि हेल्म चार्टहरूको लागि मानहरू सेट गर्न सक्नुहुन्छ, तर के हुन्छ यदि हामीसँग धेरै वातावरणहरू वर्णन गरिएको छ, र हामी चाहन्छौं, उदाहरणका लागि, सबैका लागि समान सेट गर्न। 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 (इन्फ्रास्ट्रक्चर-एज-कोड) लाई माया गर्छु र तैनाती अवस्थाको स्पष्ट विवरण पाउन चाहन्छु।

अन्तमा, म थप्न चाहन्छु कि पूर्वनिर्धारित वातावरणका लागि चरहरू, बदलेमा, एक निश्चित धावकको ओएसको वातावरणीय चरहरूसँग प्यारामिटराइज गर्न सकिन्छ जहाँबाट डिप्लोयमेन्ट सुरु हुनेछ, र यसरी गतिशील वातावरणहरू प्राप्त गर्न सकिन्छ।

helmfile.yaml

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

स्रोत: www.habr.com