მრავალ k8s გარემოში განლაგების ორგანიზება helmfile-ის გამოყენებით

ჩაფხუტი - შესაფუთი ამისთვის საჭესთან, რომელიც საშუალებას გაძლევთ აღწეროთ საჭის მრავალი გამოშვება ერთ ადგილას, პარამეტრულად მოახდინოთ მათი დიაგრამები რამდენიმე გარემოსთვის და ასევე დააყენოთ მათი განლაგების რიგი.

თქვენ შეგიძლიათ წაიკითხოთ თავად helmfile-ზე და მისი გამოყენების მაგალითებზე წამიკითხე и საუკეთესო პრაქტიკის სახელმძღვანელო.

ჩვენ გავეცნობით Helffile-ში გამოშვებების აღწერის არა აშკარა გზებს

ვთქვათ, გვაქვს საჭის დიაგრამების პაკეტი (მაგალითად, პოსტგრესი და ზოგიერთი backend აპლიკაცია) და რამდენიმე გარემო (რამდენიმე კუბერნეტის კლასტერი, რამდენიმე სახელთა სივრცე, ან ორივედან რამდენიმე). ჩვენ ვიღებთ ჩაფხუტს, ვკითხულობთ დოკუმენტაციას და ვიწყებთ ჩვენი გარემოსა და გამოშვების აღწერას:

    .
    ├── 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 გააფართოვეთ პოსტგრესი, რადგან ვიცით, რომ არ გვჭირდება მონაცემთა ბაზის k8-ებში გადატანა და გასაყიდად გვაქვს მშვენიერი ცალკე პოსტგრეს კლასტერი? ამ პრობლემის გადასაჭრელად ჩვენ გვაქვს ეტიკეტები

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: აუცილებელია იამლის გამყოფის გამოყენება ---, ასე რომ თქვენ შეგიძლიათ შაბლონი რელიზები (და სხვა ნაწილები, როგორიცაა 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, რათა 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 }}

შენიშვნა

ცხადია, პოსტგრესის ჩარტში შესვლა უკიდურესად საეჭვოა, ამიტომ ეს სტატია მოცემულია უბრალოდ, როგორც სფერული მაგალითი ვაკუუმში და იმისთვის, რომ სტატიაში ახალი გამოშვება არ შემოვიდეს მხოლოდ შეღწევის აღწერისთვის.

საიდუმლოების ჩანაცვლება გარემოს ღირებულებებიდან

ზემოთ მოყვანილი მაგალითის ანალოგიით, თქვენ შეგიძლიათ ჩაანაცვლოთ დაშიფრული პირების გამოყენებით საჭის საიდუმლოებები მნიშვნელობები. იმის ნაცვლად, რომ შევქმნათ საკუთარი საიდუმლო ფაილი თითოეული გამოშვებისთვის, რომელშიც ჩვენ შეგვიძლია განვსაზღვროთ დაშიფრული მნიშვნელობები დიაგრამისთვის, ჩვენ შეგვიძლია უბრალოდ განვსაზღვროთ გამოშვებაში 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 შაბლონებისთვის helmfile-ში, რომელიც, თუნდაც .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