Terraform პროვაიდერი Selectel

ჩვენ გავუშვით ოფიციალური Terraform პროვაიდერი Selectel-თან მუშაობისთვის. ეს პროდუქტი მომხმარებლებს საშუალებას აძლევს სრულად განახორციელონ რესურსების მართვა ინფრასტრუქტურა-როგორც კოდი მეთოდოლოგიით.

პროვაიდერი ამჟამად მხარს უჭერს სერვისის რესურსების მართვას "ვირტუალური პირადი ღრუბელი" (შემდგომში VPC). სამომავლოდ, ჩვენ ვგეგმავთ რესურსების მართვის დამატებას Selectel-ის მიერ მოწოდებული სხვა სერვისებისთვის.

როგორც უკვე იცით, VPC სერვისი აგებულია OpenStack-ზე. თუმცა, იმის გამო, რომ OpenStack არ გთავაზობთ ადგილობრივ ინსტრუმენტებს საჯარო ღრუბლის მომსახურებისთვის, ჩვენ დავაყენეთ დაკარგული ფუნქციონირება დამატებითი API-ების კომპლექტში, რომლებიც ამარტივებს რთული კომპოზიტური ობიექტების მართვას და სამუშაოს უფრო მოსახერხებელს ხდის. OpenStack-ში არსებული ზოგიერთი ფუნქციონალობა დახურულია პირდაპირი გამოყენებისგან, მაგრამ ხელმისაწვდომია ჩვენი API.

Selectel Terraform პროვაიდერი ახლა მოიცავს შემდეგი VPC რესურსების მართვის შესაძლებლობას:

• პროექტები და მათი კვოტები;
• მომხმარებლები, მათი როლები და ნიშნები;
• საჯარო ქვექსელები, მათ შორის ჯვარედინი რეგიონალური და VRRP;
• პროგრამული უზრუნველყოფის ლიცენზიები.

პროვაიდერი იყენებს ჩვენს საჯარო Go ბიბლიოთეკას VPC API-სთან მუშაობისთვის. ბიბლიოთეკაც და თავად პროვაიდერიც ღია წყაროა, მათი განვითარება ხორციელდება Github-ზე:

• ბიბლიოთეკის საცავი წადი თვითმმართველობის კლიენტი,
• პროვაიდერის საცავი Terraform-პროვაიდერი Selectel.

სხვა ღრუბლოვანი რესურსების სამართავად, როგორიცაა ვირტუალური მანქანები, დისკები, Kubernetes კლასტერები, შეგიძლიათ გამოიყენოთ OpenStack Terraform პროვაიდერი. ორივე პროვაიდერის ოფიციალური დოკუმენტაცია ხელმისაწვდომია შემდეგ ბმულებზე:

• აირჩიეთ რესურსის დოკუმენტაცია: Terraform-პროვაიდერი Selectel,
• OpenStack რესურსის დოკუმენტაცია: Terraform-პროვაიდერი OpenStack.

ნაცნობობა

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

მუშაობისთვის პროვაიდერს სჭირდება Selectel API გასაღები, რომელიც იქმნება ანგარიშის მართვის პანელები.

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

საცავი მაგალითებით დაყოფილია ორ დირექტორიად:

• მოდულები, შეიცავს მცირე მრავალჯერად გამოყენებად მოდულებს, რომლებიც იღებენ პარამეტრთა ერთობლიობას, როგორც შეყვანის სახით და მართავენ რესურსების მცირე კომპლექტს;
• მაგალითები, რომელიც შეიცავს ურთიერთდაკავშირებული მოდულების სრული ნაკრების მაგალითებს.

Terraform-ის დაყენების, Selectel API გასაღების შექმნისა და მაგალითების გაცნობის შემდეგ გადავიდეთ პრაქტიკულ მაგალითებზე.

ლოკალური დისკით სერვერის შექმნის მაგალითი

მოდით შევხედოთ პროექტის შექმნის მაგალითს, როლის მქონე მომხმარებლის და ვირტუალური მანქანა ლოკალური დისკით: terraform-examples/examples/vpc/server_local_root_disk.

ფაილში vars.tf აღწერილია ყველა პარამეტრი, რომელიც გამოყენებული იქნება მოდულების გამოძახებისას. ზოგიერთ მათგანს აქვს ნაგულისხმევი მნიშვნელობები, მაგალითად, სერვერი შეიქმნება ზონაში ru-3a შემდეგი კონფიგურაციით:

variable "server_vcpus" {
default = 4
}

variable "server_ram_mb" {
default = 8192
}

variable "server_root_disk_gb" {
default = 8
}

variable "server_image_name" {
default = "Ubuntu 18.04 LTS 64-bit"
}

ფაილში მთავარი.ტფ Selectel პროვაიდერის ინიციალიზაცია ხდება:

provider "selectel" {
token    = "${var.sel_token}"
}

ეს ფაილი ასევე შეიცავს ნაგულისხმევ მნიშვნელობას SSH გასაღებისთვის, რომელიც დაინსტალირებული იქნება სერვერზე:

module "server_local_root_disk" {
...
server_ssh_key      = "${file("~/.ssh/id_rsa.pub")}"
}

საჭიროების შემთხვევაში, შეგიძლიათ მიუთითოთ სხვა საჯარო გასაღები. გასაღები არ უნდა იყოს მითითებული, როგორც ფაილის გზა; თქვენ ასევე შეგიძლიათ დაამატოთ მნიშვნელობა როგორც სტრიქონი.

შემდგომ ამ ფაილში მოდულები გაშვებულია პროექტი_მომხმარებელთან и server_local_root_disk, რომლებიც მართავენ საჭირო რესურსებს.

მოდით შევხედოთ ამ მოდულებს უფრო დეტალურად.

პროექტის და როლის მქონე მომხმარებლის შექმნა

პირველი მოდული ქმნის პროექტს და მომხმარებელს, რომელსაც აქვს როლი ამ პროექტში: terraform-examples/modules/vpc/project_with_user.

შექმნილი მომხმარებელი შეძლებს OpenStack-ში შესვლას და მისი რესურსების მართვას. მოდული მარტივია და მართავს მხოლოდ სამ ერთეულს:

• selectel_vpc_project_v2,
• selectel_vpc_user_v2,
• selectel_vpc_role_v2.

ვირტუალური სერვერის შექმნა ლოკალური დისკით

მეორე მოდული ეხება OpenStack ობიექტების მართვას, რომლებიც აუცილებელია სერვერის შესაქმნელად ლოკალური დისკით.

ყურადღება უნდა მიაქციოთ ზოგიერთ არგუმენტს, რომელიც მითითებულია ამ მოდულში რესურსისთვის openstack_compute_instance_v2:

resource "openstack_compute_instance_v2" "instance_1" {
  ...

  lifecycle {
    ignore_changes = ["image_id"]
  }

  vendor_options {
    ignore_resize_confirmation = true
  }
}

კამათი იგნორირება_ცვლილებები საშუალებას გაძლევთ უგულებელყოთ ატრიბუტების ცვლილებები id ვირტუალური მანქანის შესაქმნელად გამოყენებული სურათისთვის. VPC სერვისში საჯარო სურათების უმეტესობა ავტომატურად განახლდება კვირაში ერთხელ და ამავე დროს id ასევე იცვლება. ეს განპირობებულია OpenStack კომპონენტის - Glance-ის თავისებურებებით, რომლებშიც სურათები განიხილება უცვლელად.

თუ თქვენ ქმნით ან ცვლით არსებულ სერვერს ან დისკს, რომელსაც აქვს არგუმენტი image_id მეორადი id საჯარო სურათი, შემდეგ ამ სურათის განახლების შემდეგ Terraform manifest-ის ხელახლა გაშვება განაახლებს სერვერს ან დისკს. არგუმენტის გამოყენება იგნორირება_ცვლილებები საშუალებას გაძლევთ თავიდან აიცილოთ ასეთი სიტუაცია.

შენიშვნა: არგუმენტი იგნორირება_ცვლილებები საკმაოდ დიდი ხნის წინ გამოჩნდა Terraform-ში: pull#2525.

კამათი ignore_resize_confirmation საჭიროა ლოკალური დისკის, ბირთვების ან სერვერის მეხსიერების ზომის წარმატებით შესაცვლელად. ასეთი ცვლილებები ხდება OpenStack Nova კომპონენტის მეშვეობით მოთხოვნის გამოყენებით ზომის შეცვლა. ნაგულისხმევი Nova მოთხოვნის შემდეგ ზომის შეცვლა აყენებს სერვერს სტატუსში გადამოწმების_ ზომის შეცვლა და ელოდება მომხმარებლისგან დამატებით დადასტურებას. თუმცა, ეს ქცევა შეიძლება შეიცვალოს ისე, რომ Nova არ დაელოდება მომხმარებლისგან დამატებით მოქმედებებს.

მითითებული არგუმენტი Terraform-ს საშუალებას აძლევს არ დაელოდოს სტატუსს გადამოწმების_ ზომის შეცვლა სერვერისთვის და მოემზადეთ იმისთვის, რომ სერვერი იყოს აქტიურ სტატუსში მისი პარამეტრების შეცვლის შემდეგ. არგუმენტი ხელმისაწვდომია OpenStack Terraform პროვაიდერის 1.10.0 ვერსიიდან: pull#422.

რესურსების შექმნა

მანიფესტების გაშვებამდე, გთხოვთ გაითვალისწინოთ, რომ ჩვენს მაგალითში გაშვებულია ორი განსხვავებული პროვაიდერი, ხოლო OpenStack პროვაიდერი დამოკიდებულია Selectel პროვაიდერის რესურსებზე, რადგან პროექტში მომხმარებლის შექმნის გარეშე შეუძლებელია მისი კუთვნილი ობიექტების მართვა. . სამწუხაროდ, იმავე მიზეზით ჩვენ არ შეგვიძლია უბრალოდ გაუშვათ ბრძანება ტერაფორმის გამოყენება ჩვენი მაგალითის შიგნით. ჩვენ ჯერ უნდა გავაკეთოთ ვრცელდება მოდულისთვის პროექტი_მომხმარებელთან და ამის შემდეგ ყველა დანარჩენისთვის.

შენიშვნა: ეს საკითხი ჯერ არ არის მოგვარებული Terraform-ში, შეგიძლიათ თვალი ადევნოთ განხილვას Github-ზე ნომერი #2430 и ნომერი #4149.

რესურსების შესაქმნელად გადადით დირექტორიაში terraform-examples/examples/vpc/server_local_root_disk, მისი შინაარსი უნდა იყოს ასეთი:

$ ls
README.md	   main.tf		vars.tf

ჩვენ მოდულების ინიციალიზაციას ვაკეთებთ ბრძანების გამოყენებით:

$ terraform init

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

ჯერ გამოვიყენოთ მოდული პროექტი_მომხმარებელთან. ეს მოითხოვს მნიშვნელობების ხელით გადაცემას იმ ცვლადებისთვის, რომლებიც არ არის დაყენებული:

• sel_ანგარიში თქვენი Selectel ანგარიშის ნომრით;
• sel_token თქვენი გასაღებით Selectel API-სთვის;
• მომხმარებლის პაროლი პაროლით OpenStack მომხმარებლისთვის.

პირველი ორი ცვლადის მნიშვნელობები უნდა იყოს აღებული მართვის პანელები.

ბოლო ცვლადისთვის შეგიძლიათ ნებისმიერი პაროლის მოძიება.

მოდულის გამოსაყენებლად საჭიროა მნიშვნელობების შეცვლა SEL_ACCOUNT, SEL_TOKEN и ᲛᲝᲛᲮᲛᲐᲠᲔᲑᲚᲘᲡ ᲞᲐᲠᲝᲚᲘ ბრძანების გაშვება:

$ env 
TF_VAR_sel_account=SEL_ACCOUNT 
TF_VAR_sel_token=SEL_TOKEN 
TF_VAR_user_password=USER_PASSWORD 
terraform apply -target=module.project_with_user

ბრძანების გაშვების შემდეგ, Terraform აჩვენებს რა რესურსების შექმნას სურს და ითხოვს დადასტურებას:

Plan: 3 to add, 0 to change, 0 to destroy.

Do you want to perform these actions?
Terraform will perform the actions described above.
Only 'yes' will be accepted to approve.

Enter a value: yes

პროექტის, მომხმარებლის და როლის შექმნის შემდეგ, შეგიძლიათ დაიწყოთ დარჩენილი რესურსების შექმნა:

$ env 
TF_VAR_sel_account=SEL_ACCOUNT 
TF_VAR_sel_token=SEL_TOKEN 
TF_VAR_user_password=USER_PASSWORD 
terraform apply

რესურსების შექმნისას ყურადღება მიაქციეთ Terraform-ის გამომავალს გარე IP მისამართით, სადაც შექმნილი სერვერი იქნება ხელმისაწვდომი:

module.server_local_root_disk.openstack_networking_floatingip_associate_v2.association_1: Creating...
  floating_ip: "" => "x.x.x.x"

თქვენ შეგიძლიათ იმუშაოთ შექმნილ ვირტუალურ მანქანასთან SSH-ის საშუალებით მითითებული IP-ის გამოყენებით.

რესურსების რედაქტირება

Terraform-ის საშუალებით რესურსების შექმნის გარდა, მათი შეცვლაც შესაძლებელია.

მაგალითად, მოდით გავზარდოთ ბირთვების და მეხსიერების რაოდენობა ჩვენი სერვერისთვის, პარამეტრების მნიშვნელობების შეცვლით. server_vcpus и server_ram_mb ფაილში examples/vpc/server_local_root_disk/main.tf:

-  server_vcpus        = "${var.server_vcpus}"
-  server_ram_mb       = "${var.server_ram_mb}"
+  server_vcpus        = 8
+  server_ram_mb       = 10240

ამის შემდეგ, ჩვენ ვამოწმებთ რა ცვლილებებს გამოიწვევს ეს შემდეგი ბრძანების გამოყენებით:

$ env 
TF_VAR_sel_account=SEL_ACCOUNT 
TF_VAR_sel_token=SEL_TOKEN 
TF_VAR_user_password=USER_PASSWORD 
terraform plan

შედეგად, Terraform-მა შეცვალა რესურსი openstack_compute_instance_v2 и openstack_compute_flavor_v2.

გთხოვთ გაითვალისწინოთ, რომ ეს გამოიწვევს შექმნილი ვირტუალური მანქანის გადატვირთვას.

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

ყველა შექმნილი ობიექტი გამოჩნდება VPC მართვის პანელები:

ჩვენს საცავების მაგალითი თქვენ ასევე შეგიძლიათ იხილოთ მანიფესტები ქსელური დისკებით ვირტუალური მანქანების შესაქმნელად.

Kubernetes კლასტერის შექმნის მაგალითი

სანამ შემდეგ მაგალითზე გადავალთ, ჩვენ გავასუფთავებთ ადრე შექმნილ რესურსებს. ამის გაკეთება პროექტის ძირში terraform-examples/examples/vpc/server_local_root_disk მოდით გავუშვათ ბრძანება OpenStack ობიექტების წასაშლელად:

$ env 
TF_VAR_sel_account=SEL_ACCOUNT 
TF_VAR_sel_token=SEL_TOKEN 
TF_VAR_user_password=USER_PASSWORD 
terraform destroy -target=module.server_local_root_disk

შემდეგ გაუშვით ბრძანება Selectel VPC API ობიექტების გასასუფთავებლად:

$ env 
TF_VAR_sel_account=SEL_ACCOUNT 
TF_VAR_sel_token=SEL_TOKEN 
TF_VAR_user_password=USER_PASSWORD 
terraform destroy -target=module.project_with_user

ორივე შემთხვევაში, თქვენ უნდა დაადასტუროთ ყველა ობიექტის წაშლა:

Do you really want to destroy all resources?
Terraform will destroy all your managed infrastructure, as shown above.
There is no undo. Only 'yes' will be accepted to confirm.

Enter a value: yes

შემდეგი მაგალითი არის დირექტორიაში terraform-examples/examples/vpc/kubernetes_cluster.

ეს მაგალითი ქმნის პროექტს, მომხმარებელს, რომელსაც აქვს როლი პროექტში და აყენებს ერთ Kubernetes კლასტერს. ფაილში vars.tf შეგიძლიათ ნახოთ ნაგულისხმევი მნიშვნელობები, როგორიცაა კვანძების რაოდენობა, მათი მახასიათებლები, Kubernetes ვერსია და ა.შ.

პირველი მაგალითის მსგავსი რესურსების შესაქმნელად, პირველ რიგში დავიწყებთ მოდულების ინიციალიზაციას და მოდულის რესურსების შექმნას პროექტი_მომხმარებელთანდა შემდეგ ყველაფერი დანარჩენის შექმნა:

$ terraform init

$ env 
TF_VAR_sel_account=SEL_ACCOUNT 
TF_VAR_sel_token=SEL_TOKEN 
TF_VAR_user_password=USER_PASSWORD 
terraform apply -target=module.project_with_user

$ env 
TF_VAR_sel_account=SEL_ACCOUNT 
TF_VAR_sel_token=SEL_TOKEN 
TF_VAR_user_password=USER_PASSWORD 
terraform apply

ჩვენ გადავიტანთ Kubernetes კლასტერების შექმნას და მართვას OpenStack Magnum კომპონენტის მეშვეობით. თქვენ შეგიძლიათ გაიგოთ მეტი, თუ როგორ უნდა იმუშაოთ კლასტერთან ერთ-ერთ ჩვენგანში წინა სტატიები, ისევე, როგორც ცოდნის ბაზა.

კლასტერის მომზადებისას შეიქმნება დისკები და ვირტუალური მანქანები და დამონტაჟდება ყველა საჭირო კომპონენტი. მომზადებას დაახლოებით 4 წუთი სჭირდება, ამ დროის განმავლობაში Terraform აჩვენებს შეტყობინებებს, როგორიცაა:

module.kubernetes_cluster.openstack_containerinfra_cluster_v1.cluster_1: Still creating... (3m0s elapsed)

ინსტალაციის დასრულების შემდეგ, Terraform მიუთითებს, რომ კლასტერი მზად არის და აჩვენებს მის ID-ს:

module.kubernetes_cluster.openstack_containerinfra_cluster_v1.cluster_1: Creation complete after 4m20s (ID: 3c8...)

Apply complete! Resources: 6 added, 0 changed, 0 destroyed.

შექმნილი Kubernetes კლასტერის მართვა უტილიტის საშუალებით კუბექტლი თქვენ უნდა მიიღოთ კლასტერული წვდომის ფაილი. ამისათვის გადადით Terraform-ის მეშვეობით შექმნილ პროექტზე თქვენს ანგარიშში არსებული პროექტების სიაში:

შემდეგი, მიჰყევით ბმულს like xxxxxx.selvpc.ruრომელიც ჩანს პროექტის სახელის ქვემოთ:

შესვლის ინფორმაციისთვის გამოიყენეთ მომხმარებლის სახელი და პაროლი, რომელიც შექმენით Terraform-ის მეშვეობით. თუ არ მოგატყუე vars.tf ან მთავარი.ტფ ჩვენი მაგალითისთვის, მომხმარებელს ექნება სახელი tf_user. თქვენ უნდა გამოიყენოთ ცვლადის მნიშვნელობა, როგორც პაროლი TF_VAR_user_password, რომელიც მითითებული იყო გაშვებისას ტერაფორმის გამოყენება ადრე.

პროექტის შიგნით თქვენ უნდა გადახვიდეთ ჩანართზე კუბერნეტები:

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

ინსტალაციის ინსტრუქციები განთავსებულია იმავე ჩანართზე. კუბექტლი და გადმოწერილის გამოყენება config.yaml.

გაშვების შემდეგ კუბექტლი და გარემოს ცვლადის დაყენება KUBECONFIG შეგიძლიათ გამოიყენოთ Kubernetes:

$ kubectl get pods --all-namespaces

NAMESPACE        NAME                                    READY  STATUS  RESTARTS AGE
kube-system   coredns-9578f5c87-g6bjf                      1/1   Running   0 8m
kube-system   coredns-9578f5c87-rvkgd                     1/1   Running   0 6m
kube-system   heapster-866fcbc879-b6998                 1/1   Running   0 8m
kube-system   kube-dns-autoscaler-689688988f-8cxhf             1/1   Running   0 8m
kube-system   kubernetes-dashboard-7bdb5d4cd7-jcjq9          1/1   Running   0 8m
kube-system   monitoring-grafana-84c97bb64d-tc64b               1/1   Running   0 8m
kube-system   monitoring-influxdb-7c8ccc75c6-dzk5f                1/1   Running   0 8m
kube-system   node-exporter-tf-cluster-rz6nggvs4va7-minion-0 1/1   Running   0 8m
kube-system   node-exporter-tf-cluster-rz6nggvs4va7-minion-1 1/1   Running   0 8m
kube-system   openstack-cloud-controller-manager-8vrmp        1/1   Running   3 8m
prometeus-monitoring   grafana-76bcb7ffb8-4tm7t       1/1   Running   0 8m
prometeus-monitoring   prometheus-75cdd77c5c-w29gb           1/1   Running   0 8m

კლასტერული კვანძების რაოდენობა მარტივად შეიძლება შეიცვალოს Terraform-ის საშუალებით.
ფაილში მთავარი.ტფ მითითებულია შემდეგი მნიშვნელობა:

cluster_node_count = "${var.cluster_node_count}"

ეს მნიშვნელობა ჩანაცვლებულია vars.tf:

variable "cluster_node_count" {
default = 2
}

თქვენ შეგიძლიათ შეცვალოთ ნაგულისხმევი მნიშვნელობა vars.tf, ან მიუთითეთ საჭირო მნიშვნელობა პირდაპირ მთავარი.ტფ:

-  cluster_node_count = "${var.cluster_node_count}"
+  cluster_node_count = 3

ცვლილებების გამოსაყენებლად, როგორც პირველი მაგალითის შემთხვევაში, გამოიყენეთ ბრძანება ტერაფორმის გამოყენება:

$ env 
TF_VAR_sel_account=SEL_ACCOUNT 
TF_VAR_sel_token=SEL_TOKEN 
TF_VAR_user_password=USER_PASSWORD 
terraform apply

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

$ kubectl get nodes
NAME                               STATUS                     ROLES     AGE   VERSION
tf-cluster-rz6nggvs4va7-master-0   Ready,SchedulingDisabled   master    8m    v1.12.4
tf-cluster-rz6nggvs4va7-minion-0   Ready                      <none>    8m    v1.12.4
tf-cluster-rz6nggvs4va7-minion-1   Ready                      <none>    8m    v1.12.4
tf-cluster-rz6nggvs4va7-minion-2   Ready                      <none>    3m    v1.12.4

დასკვნა

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

Selectel Terraform-ის პროვაიდერში აღმოჩენილი ნებისმიერი ხარვეზის შესახებ შეტყობინება შესაძლებელია Github საკითხები.

წყარო: www.habr.com