हेल्मफाइल वापरून एकाधिक 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