হেলমফাইল ব্যবহার করে একাধিক 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