ქათამი ან კვერცხი: IaC-ის გაყოფა

რა იყო პირველი - ქათამი თუ კვერცხი? საკმაოდ უცნაური დასაწყისია სტატიისთვის Infrastructure-as-Code-ის შესახებ, არა?

რა არის კვერცხი?

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

1. რესურსების უზრუნველყოფა. ეს არის VMs, S3, VPC და ა.შ. მუშაობის ძირითადი ინსტრუმენტები: Terraform и CloudFormation.
2. პროგრამული უზრუნველყოფის კონფიგურაცია. ძირითადი ინსტრუმენტები: შეუძლებელია, შეფ და ა.შ.

ნებისმიერი კოდი არის git საცავებში. და ადრე თუ გვიან გუნდის ლიდერი გადაწყვეტს, რომ ისინი უნდა მოწესრიგდნენ. და ის განაახლებს. და ეს შექმნის გარკვეულ სტრუქტურას. და ის დაინახავს, ​​რომ ეს კარგია.

ასევე კარგია, რომ ის უკვე არსებობს გიტლაბი и GitHub-პროვაიდერი Terraform-ისთვის (და ეს არის პროგრამული უზრუნველყოფის კონფიგურაცია). მათი დახმარებით თქვენ შეგიძლიათ მართოთ მთელი პროექტი: გუნდის წევრები, CI/CD, git-flow და ა.შ.

საიდან გაჩნდა კვერცხი?

ასე რომ, ჩვენ თანდათან ვუახლოვდებით მთავარ კითხვას.

უპირველეს ყოვლისა, თქვენ უნდა დაიწყოთ საცავი, რომელიც აღწერს სხვა საცავების სტრუქტურას, მათ შორის საკუთარ თავს. და რა თქმა უნდა, როგორც GitOps-ის ნაწილი, თქვენ უნდა დაამატოთ CI, რათა ცვლილებები ავტომატურად შესრულდეს.

თუ Git ჯერ არ არის შექმნილი?

1. როგორ შევინახოთ ის Git-ში?
2. როგორ დავაყენოთ CI?
3. თუ ჩვენ ასევე განვათავსებთ Gitlab-ს IaC-ის გამოყენებით და თუნდაც Kubernetes-ში?
4. და GitLab Runner ასევე Kubernetes-ში?
5. რაც შეეხება Kubernetes-ს ღრუბლოვან პროვაიდერში?

რა იყო პირველი: GitLab, სადაც მე ავტვირთავ ჩემს კოდს, ან კოდი, რომელიც აღწერს, როგორი GitLab მჭირდება?

ქათამი კვერცხთან ერთად

«ოიაკოდონი3 დინოზავრით" [src]

შევეცადოთ მოვამზადოთ კერძი ღრუბლის პროვაიდერის გამოყენებით მართავდა Kubernetes Selectel.

TL; DR

შესაძლებელია თუ არა ერთ გუნდში ერთდროულად გაწევრიანება?

$ export MY_SELECTEL_TOKEN=<token>
$ curl https://gitlab.com/chicken-or-egg/mks/make/-/snippets/2002106/raw | bash

შემადგენლობა:

• ანგარიში my.selectel.ru-დან;
• ანგარიშის ჟეტონი;
• კუბერნეტის უნარები;
• Helm Skills;
• ტერაფორმული უნარები;
• ჩაფხუტის სქემა GitLab;
• Helm chart GitLab Runner.

Recipe:

1. მიიღეთ MY_SELECTEL_TOKEN პანელიდან my.selectel.ru.
2. შექმენით Kubernetes კლასტერი მასში ანგარიშის ტოკენის გადაცემით.
3. მიიღეთ KUBECONFIG შექმნილი კლასტერიდან.
4. დააინსტალირეთ GitLab Kubernetes-ზე.
5. მიიღეთ GitLab-token მომხმარებლისთვის შექმნილი GitLab-ისგან root.
6. შექმენით პროექტის სტრუქტურა GitLab-ში GitLab-token-ის გამოყენებით.
7. გადაიტანეთ არსებული კოდი GitLab-ში.
8. ?
9. მოგება

ნაბიჯი 1. ჟეტონის მიღება შესაძლებელია განყოფილებაში API გასაღებები.

ნაბიჯი 2. ჩვენ ვამზადებთ ჩვენს Terraform-ს 2 კვანძისგან შემდგარი მტევნის "გამოსაცხობისთვის". თუ დარწმუნებული ხართ, რომ საკმარისი რესურსები გაქვთ ყველაფრისთვის, მაშინ შეგიძლიათ ჩართოთ ავტომატური კვოტები:

provider "selectel" {
 token = var.my_selectel_token
}

variable "my_selectel_token" {}
variable "username" {}
variable "region" {}


resource "selectel_vpc_project_v2" "my-k8s" {
 name = "my-k8s-cluster"
 theme = {
   color = "269926"
 }
 quotas {
   resource_name = "compute_cores"
   resource_quotas {
     region = var.region
     zone = "${var.region}a"
     value = 16
   }
 }
 quotas {
   resource_name = "network_floatingips"
   resource_quotas {
     region = var.region
     value = 1
   }
 }
 quotas {
   resource_name = "load_balancers"
   resource_quotas {
     region = var.region
     value = 1
   }
 }
 quotas {
   resource_name = "compute_ram"
   resource_quotas {
     region = var.region
     zone = "${var.region}a"
     value = 32768
   }
 }
 quotas {
   resource_name = "volume_gigabytes_fast"
   resource_quotas {
     region = var.region
     zone = "${var.region}a"
     # (20 * 2) + 50 + (8 * 3 + 10)
     value = 130
   }
 }
}

resource "selectel_mks_cluster_v1" "k8s-cluster" {
 name         = "k8s-cluster"
 project_id   = selectel_vpc_project_v2.my-k8s.id
 region       = var.region
 kube_version = "1.17.9"
}

resource "selectel_mks_nodegroup_v1" "nodegroup_1" {
 cluster_id        = selectel_mks_cluster_v1.k8s-cluster.id
 project_id        = selectel_mks_cluster_v1.k8s-cluster.project_id
 region            = selectel_mks_cluster_v1.k8s-cluster.region
 availability_zone = "${var.region}a"
 nodes_count       = 2
 cpus              = 8
 ram_mb            = 16384
 volume_gb         = 15
 volume_type       = "fast.${var.region}a"
 labels            = {
   "project": "my",
 }
}

დაამატეთ მომხმარებელი პროექტში:

resource "random_password" "my-k8s-user-pass" {
 length = 16
 special = true
 override_special = "_%@"
}

resource "selectel_vpc_user_v2" "my-k8s-user" {
 password = random_password.my-k8s-user-pass.result
 name = var.username
 enabled  = true
}

resource "selectel_vpc_keypair_v2" "my-k8s-user-ssh" {
 public_key = file("~/.ssh/id_rsa.pub")
 user_id    = selectel_vpc_user_v2.my-k8s-user.id
 name = var.username
}

resource "selectel_vpc_role_v2" "my-k8s-role" {
 project_id = selectel_vpc_project_v2.my-k8s.id
 user_id    = selectel_vpc_user_v2.my-k8s-user.id
}

გამოყვანა:

output "project_id" {
 value = selectel_vpc_project_v2.my-k8s.id
}

output "k8s_id" {
 value = selectel_mks_cluster_v1.k8s-cluster.id
}

output "user_name" {
 value = selectel_vpc_user_v2.my-k8s-user.name
}

output "user_pass" {
 value = selectel_vpc_user_v2.my-k8s-user.password
}

დავიწყოთ:

$ env 
TF_VAR_region=ru-3 
TF_VAR_username=diamon 
TF_VAR_my_selectel_token=<token> 
terraform plan -out planfile

$ terraform apply -input=false -auto-approve planfile

ნაბიჯი 3. ჩვენ ვიღებთ cubeconfig.

KUBECONFIG პროგრამულად ჩამოსატვირთად, თქვენ უნდა მიიღოთ ჟეტონი OpenStack-დან:

openstack token issue -c id -f value > token

და ამ ნიშნით მიმართეთ მართულ Kubernetes Selectel API-ს. k8s_id გასცემს terraform:

curl -XGET -H "x-auth-token: $(cat token)" "https://ru-3.mks.selcloud.ru/v1/clusters/$(cat k8s_id)/kubeconfig" -o kubeConfig.yaml

Cupconfig-ზე წვდომა ასევე შესაძლებელია პანელის საშუალებით.

ნაბიჯი 4. მას შემდეგ, რაც მტევანი გამომცხვარი იქნება და მასზე წვდომა გვექნება, ზემოდან შეგვიძლია დავამატოთ იამლი გემოვნებით.

მირჩევნია დავამატო:

• სახელთა სივრცე
• შენახვის კლასი
• pod უსაფრთხოების პოლიტიკა და ასე შემდეგ.

შენახვის კლასი Selectel-ისთვის შეიძლება აღებული იყოს ოფიციალური საცავი.

მას შემდეგ, რაც თავდაპირველად მე შევარჩიე კლასტერი ზონაში ru-3a, მაშინ მე მჭირდება შენახვის კლასი ამ ზონიდან.

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
 name: fast.ru-3a
 annotations:
   storageclass.kubernetes.io/is-default-class: "true"
provisioner: cinder.csi.openstack.org
parameters:
 type: fast.ru-3a
 availability: ru-3a
allowVolumeExpansion: true

ნაბიჯი 5. დააინსტალირეთ დატვირთვის ბალანსერი.

ჩვენ გამოვიყენებთ სტანდარტულს ბევრისთვის nginx-ingress. უკვე არსებობს უამრავი ინსტრუქცია მისი ინსტალაციისთვის, ასე რომ ჩვენ მასზე არ ვისაუბრებთ.

$ helm repo add nginx-stable https://helm.nginx.com/stable
$ helm upgrade nginx-ingress nginx-stable/nginx-ingress -n ingress --install -f ../internal/K8S-cluster/ingress/values.yml

ჩვენ ველოდებით გარე IP-ს მიღებას დაახლოებით 3-4 წუთის განმავლობაში:

მიღებული გარე IP:

ნაბიჯი 6. დააინსტალირეთ GitLab.

$ helm repo add gitlab https://charts.gitlab.io
$ helm upgrade gitlab gitlab/gitlab -n gitlab  --install -f gitlab/values.yml --set "global.hosts.domain=gitlab.$EXTERNAL_IP.nip.io"

ისევ ველოდებით ყველა ღვეზელის ამოსვლას.

kubectl get po -n gitlab
NAME                                      	READY   STATUS  	RESTARTS   AGE
gitlab-gitaly-0                           	0/1 	Pending 	0      	0s
gitlab-gitlab-exporter-88f6cc8c4-fl52d    	0/1 	Pending 	0      	0s
gitlab-gitlab-runner-6b6867c5cf-hd9dp     	0/1 	Pending 	0      	0s
gitlab-gitlab-shell-55cb6ccdb-h5g8x       	0/1 	Init:0/2	0      	0s
gitlab-migrations.1-2cg6n                 	0/1 	Pending 	0      	0s
gitlab-minio-6dd7d96ddb-zd9j6             	0/1 	Pending 	0      	0s
gitlab-minio-create-buckets.1-bncdp       	0/1 	Pending 	0      	0s
gitlab-postgresql-0                       	0/2 	Pending 	0      	0s
gitlab-prometheus-server-6cfb57f575-v8k6j 	0/2 	Pending 	0      	0s
gitlab-redis-master-0                     	0/2 	Pending 	0      	0s
gitlab-registry-6bd77b4b8c-pb9v9          	0/1 	Pending 	0      	0s
gitlab-registry-6bd77b4b8c-zgb6r          	0/1 	Init:0/2	0      	0s
gitlab-shared-secrets.1-pc7-5jgq4         	0/1 	Completed   0      	20s
gitlab-sidekiq-all-in-1-v1-54dbcf7f5f-qbq67   0/1 	Pending 	0      	0s
gitlab-task-runner-6fd6857db7-9x567       	0/1 	Pending 	0      	0s
gitlab-webservice-d9d4fcff8-hp8wl         	0/2 	Pending 	0      	0s
Waiting gitlab
./wait_gitlab.sh ../internal/gitlab/gitlab/.pods
waiting for pod...
waiting for pod...
waiting for pod...

წიპწები გაიზარდა:

ნაბიჯი 7. ჩვენ ვიღებთ GitLab-token-ს.

პირველ რიგში, გაიგეთ შესვლის პაროლი:

kubectl get secret -n gitlab gitlab-gitlab-initial-root-password -o jsonpath='{.data.password}' | base64 --decode

ახლა მოდით შეხვიდეთ სისტემაში და მივიღოთ ჟეტონი:

python3 get_gitlab_token.py root $GITLAB_PASSWORD http://gitlab.gitlab.$EXTERNAL_IP.nip.io

ნაბიჯი 8. Git საცავების სწორ იერარქიაში მიტანა Gitlab პროვაიდერის გამოყენებით.

cd ../internal/gitlab/hierarchy && terraform apply -input=false -auto-approve planfile

სამწუხაროდ, terraform GitLab პროვაიდერს აქვს მცურავი შეცდომა. შემდეგ თქვენ მოგიწევთ ხელით წაშალოთ კონფლიქტური პროექტები, რათა tf.state გამოსწორდეს. შემდეგ კვლავ გაუშვით ბრძანება `$make all`

ნაბიჯი 9. ჩვენ გადავცემთ ადგილობრივ საცავებს სერვერზე.

$ make push

[master (root-commit) b61d977]  Initial commit
 3 files changed, 46 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 values.yml
Enumerating objects: 5, done.
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads
Compressing objects: 100% (5/5), done.
Writing objects: 100% (5/5), 770 bytes | 770.00 KiB/s, done.
Total 5 (delta 0), reused 0 (delta 0)

შესრულებულია:

დასკვნა

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

გამოიწერეთ ჩვენი წაკითხვარათა არ გამოტოვოთ ახალი სტატიების გამოშვება!

წყარო: www.habr.com