MÄs esam uzsÄkuÅ”i oficiÄlo Terraform nodroÅ”inÄtÄju darbam ar Selectel. Å is produkts ļauj lietotÄjiem pilnÄ«bÄ ieviest resursu pÄrvaldÄ«bu, izmantojot metodi Infrastructure-as-code (infrastruktÅ«ra kÄ kods).
Pakalpojumu sniedzÄjs paÅ”laik atbalsta pakalpojumu resursu pÄrvaldÄ«bu (turpmÄk VPC). NÄkotnÄ plÄnojam tai pievienot arÄ« citu Selectel sniegto pakalpojumu resursu pÄrvaldÄ«bu.
KÄ jÅ«s jau zinÄt, VPC pakalpojums ir izveidots uz OpenStack. TomÄr, Åemot vÄrÄ to, ka OpenStack nenodroÅ”ina vietÄjos rÄ«kus publiskÄ mÄkoÅa apkalpoÅ”anai, mÄs esam ieviesuÅ”i trÅ«kstoÅ”o funkcionalitÄti papildu API komplektÄ, kas vienkÄrÅ”o sarežģītu saliktu objektu pÄrvaldÄ«bu un padara darbu ÄrtÄku. Daļa no OpenStack pieejamÄs funkcionalitÄtes ir slÄgta no tieÅ”as lietoÅ”anas, taÄu ir pieejama caur .
Selectel Terraform nodroÅ”inÄtÄjs tagad var pÄrvaldÄ«t Å”Ädus VPC resursus:
- projekti un to kvotas;
- lietotÄji, viÅu lomas un marÄ·ieri;
- publiskie apakŔtīkli, tostarp starpreģionu un VRRP;
- programmatūras licences.
Pakalpojumu sniedzÄjs izmanto mÅ«su publisko Go bibliotÄku, lai strÄdÄtu ar VPC API. Gan bibliotÄka, gan pats nodroÅ”inÄtÄjs ir atvÄrtÄ pirmkoda, tie tiek izstrÄdÄti vietnÄ Github:
- bibliotÄkas krÄtuve ,
- nodroÅ”inÄtÄja repozitorijs .
Lai pÄrvaldÄ«tu pÄrÄjos mÄkoÅa resursus, piemÄram, virtuÄlÄs maŔīnas, diskus, Kubernetes klasterus, varat izmantot OpenStack Terraform nodroÅ”inÄtÄju. OficiÄlÄ dokumentÄcija abiem pakalpojumu sniedzÄjiem ir pieejama Å”ajÄs saitÄs:
- Atlasiet resursa dokumentÄciju: ,
- OpenStack resursu dokumentÄcija: .
Darba sÄkÅ”ana
Lai sÄktu, jums jÄinstalÄ Terraform (instrukcijas un saites uz instalÄcijas pakotnÄm var atrast vietnÄ ).
Lai strÄdÄtu, pakalpojumu sniedzÄjam ir nepiecieÅ”ama Selectel API atslÄga, kas ir izveidota .
Manifesti darbam ar Selectel tiek izveidoti, izmantojot Terraform vai izmantojot gatavu piemÄru kopu, kas ir pieejama mÅ«su Github repozitorijÄ: .
Repozitorijs ar piemÄriem ir sadalÄ«ts divos direktorijos:
- moduļi, kas satur mazus atkÄrtoti lietojamus moduļus, kas izmanto parametru kopu kÄ ievadi un pÄrvalda nelielu resursu kopu;
- piemÄri, kurÄ ir piemÄri pilnam savstarpÄji savienotu moduļu komplektam.
PÄc Terraform instalÄÅ”anas, Selectel API atslÄgas izveidoÅ”anas un piemÄru pÄrskatÄ«Å”anas, pÄriesim pie praktiskiem piemÄriem.
PiemÄrs servera izveidei ar lokÄlo disku
Apsveriet piemÄru, kÄ izveidot projektu, lietotÄju ar lomu un virtuÄlo maŔīnu ar vietÄjo disku: .
FailÄ vars.tf ir aprakstÄ«ti visi parametri, kas tiks izmantoti, izsaucot moduļus. DažÄm no tÄm ir noklusÄjuma vÄrtÄ«bas, piemÄram, serveris tiks izveidots zonÄ lv-3a ar Å”Ädu konfigurÄciju:
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"
}
FailÄ galvenais.tf Selectel nodroÅ”inÄtÄjs ir inicializÄts:
provider "selectel" {
token = "${var.sel_token}"
}
Å ajÄ failÄ ir arÄ« noklusÄjuma vÄrtÄ«ba SSH atslÄgai, kas tiks instalÄta serverÄ«:
module "server_local_root_disk" {
...
server_ssh_key = "${file("~/.ssh/id_rsa.pub")}"
}
Ja nepiecieÅ”ams, varat norÄdÄ«t citu publisko atslÄgu. AtslÄga nav jÄnorÄda kÄ ceļŔ uz failu, vÄrtÄ«bu var pievienot arÄ« kÄ virkni.
TÄlÄk Å”ajÄ failÄ tiek palaisti moduļi projekts_ar_lietotÄju Šø server_local_root_diskkas pÄrvalda nepiecieÅ”amos resursus.
ApskatÄ«sim Å”os moduļus tuvÄk.
Izveidojiet projektu un lietotÄju ar lomu
Pirmais modulis izveido projektu un lietotÄju ar lomu Å”ajÄ projektÄ: .
Izveidotais lietotÄjs varÄs pieteikties OpenStack un pÄrvaldÄ«t tÄ resursus. Modulis ir vienkÄrÅ”s un pÄrvalda tikai trÄ«s entÄ«tijas:
- selectel_vpc_project_v2,
- selectel_vpc_user_v2,
- selectel_vpc_role_v2.
VirtuÄlÄ servera izveide ar lokÄlo disku
Otrais modulis ir saistÄ«ts ar OpenStack objektu pÄrvaldÄ«bu, kas nepiecieÅ”ami, lai izveidotu serveri ar lokÄlo disku.
Jums vajadzÄtu pievÄrst uzmanÄ«bu dažiem argumentiem, kas ir norÄdÄ«ti Å”ajÄ resursa modulÄ« openstack_compute_instance_v2:
resource "openstack_compute_instance_v2" "instance_1" {
...
lifecycle {
ignore_changes = ["image_id"]
}
vendor_options {
ignore_resize_confirmation = true
}
}
Arguments ignorÄt_izmaiÅas ļauj ignorÄt atribÅ«tu izmaiÅas id attÄlam, ko izmanto, lai izveidotu virtuÄlo maŔīnu. VPC servisÄ lielÄkÄ daļa publisko attÄlu tiek automÄtiski atjauninÄti reizi nedÄÄ¼Ä un tajÄ paÅ”Ä laikÄ id arÄ« mainÄs. Tas ir saistÄ«ts ar OpenStack komponenta - Glance - darbÄ«bas Ä«patnÄ«bÄm, kurÄs attÄli tiek uzskatÄ«ti par nemainÄ«gÄm entÄ«tijÄm.
Ja izveidojat vai modificÄjat esoÅ”u serveri vai disku, kuram ir kÄ arguments attÄla_id lietots id publisks attÄls, pÄc Ŕī attÄla atjauninÄÅ”anas, vÄlreiz palaižot Terraform manifestu, serveris vai disks tiks izveidots no jauna. Izmantojot argumentu ignorÄt_izmaiÅas izvairÄs no Å”Ädas situÄcijas.
piezÄ«me: arguments ignorÄt_izmaiÅas parÄdÄ«jÄs Terraform jau sen: .
Arguments ignore_resize_confirmation nepiecieÅ”ams, lai veiksmÄ«gi mainÄ«tu servera lokÄlÄ diska, serdeÅu vai atmiÅas izmÄrus. Å Ädas izmaiÅas tiek veiktas, izmantojot OpenStack Nova komponentu, izmantojot pieprasÄ«jumu mainÄ«t. NoklusÄjuma Nova pÄc pieprasÄ«juma mainÄ«t nostÄda serveri statusÄ verify_resize un gaida papildu apstiprinÄjumu no lietotÄja. TomÄr Å”o uzvedÄ«bu var mainÄ«t, lai Nova nebÅ«tu jÄgaida, lÄ«dz lietotÄjs veiks papildu darbÄ«bas.
NorÄdÄ«tais arguments ļauj Terraform negaidÄ«t statusu verify_resize serverim un esiet gatavi tam, ka serveris pÄc parametru maiÅas bÅ«s aktÄ«vÄ statusÄ. Arguments ir pieejams kopÅ” OpenStack Terraform nodroÅ”inÄtÄja versijas 1.10.0: .
Resursu izveide
Pirms manifestu palaiÅ”anas jÄÅem vÄrÄ, ka mÅ«su piemÄrÄ tiek palaisti divi dažÄdi nodroÅ”inÄtÄji, un OpenStack nodroÅ”inÄtÄjs ir atkarÄ«gs no Selectel nodroÅ”inÄtÄja resursiem, jo, neizveidojot projektÄ lietotÄju, nav iespÄjams pÄrvaldÄ«t viÅam piederoÅ”os objektus. . DiemžÄl tÄ paÅ”a iemesla dÄļ mÄs nevaram vienkÄrÅ”i palaist komandu pielietot terraformu mÅ«su piemÄrÄ. Mums vispirms jÄdara piemÄrot modulim projekts_ar_lietotÄju un pÄc tam par visu pÄrÄjo.
PiezÄ«me. PaziÅotÄ problÄma vÄl nav atrisinÄta pakalpojumÄ Terraform. Varat sekot diskusijai vietnÄ Github vietnÄ Šø .
Lai izveidotu resursus, dodieties uz direktoriju , tÄ saturam jÄbÅ«t Å”Ädam:
$ ls
README.md main.tf vars.tf
MÄs inicializÄjam moduļus, izmantojot komandu:
$ terraform init
Izvade parÄda, ka Terraform lejupielÄdÄ izmantoto pakalpojumu sniedzÄju jaunÄkÄs versijas un pÄrbauda visus piemÄrÄ aprakstÄ«tos moduļus.
Vispirms pielietojiet moduli projekts_ar_lietotÄju. Tas prasa manuÄlu vÄrtÄ«bu pÄrsÅ«tÄ«Å”anu mainÄ«gajiem, kas nav iestatÄ«ti:
- sel_konts ar savu Selectel konta numuru;
- sel_token ar savu Selectel API atslÄgu;
- lietotÄja_parole ar OpenStack lietotÄja paroli.
Pirmo divu mainÄ«go vÄrtÄ«bas ir jÄÅem no .
PÄdÄjam mainÄ«gajam varat izdomÄt jebkuru paroli.
Lai izmantotu moduli, ir jÄaizstÄj vÄrtÄ«bas SEL_KONTS, SEL_TOKEN Šø USER_PASSWORD izpildot komandu:
$ 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
PÄc komandas palaiÅ”anas Terraform parÄdÄ«s, kÄdus resursus tÄ vÄlas izveidot, un bÅ«s nepiecieÅ”ams apstiprinÄjums:
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
Kad projekts, lietotÄjs un loma ir izveidoti, varat sÄkt veidot pÄrÄjos resursus.
$ env
TF_VAR_sel_account=SEL_ACCOUNT
TF_VAR_sel_token=SEL_TOKEN
TF_VAR_user_password=USER_PASSWORD
terraform apply
Veidojot resursus, pievÄrsiet uzmanÄ«bu Terraform izvadei ar ÄrÄjo IP adresi, kurÄ bÅ«s pieejams izveidotais serveris:
module.server_local_root_disk.openstack_networking_floatingip_associate_v2.association_1: Creating...
floating_ip: "" => "x.x.x.x"
JÅ«s varat strÄdÄt ar izveidoto virtuÄlo maŔīnu, izmantojot SSH, izmantojot norÄdÄ«to IP.
Resursu rediÄ£ÄÅ”ana
Papildus resursu izveidei, izmantojot Terraform, tos var arÄ« modificÄt.
PiemÄram, palielinÄsim mÅ«su servera kodolu un atmiÅas skaitu, mainot parametru vÄrtÄ«bas serveris_vcpus Šø serveris_ram_mb failÄ 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
PÄc tam mÄs pÄrbaudÄm, pie kÄdÄm izmaiÅÄm tas novedÄ«s, izmantojot Å”Ädu komandu:
$ env
TF_VAR_sel_account=SEL_ACCOUNT
TF_VAR_sel_token=SEL_TOKEN
TF_VAR_user_password=USER_PASSWORD
terraform plan
RezultÄtÄ Terraform veica resursu izmaiÅas openstack_compute_instance_v2 Šø openstack_compute_flavor_v2.
LÅ«dzu, Åemiet vÄrÄ, ka tas nozÄ«mÄ izveidotÄs virtuÄlÄs maŔīnas pÄrstartÄÅ”anu.
Lai lietotu jauno virtuÄlÄs maŔīnas konfigurÄciju, izmantojiet komandu pielietot terraformu, kuru jau esam laiduÅ”i klajÄ iepriekÅ”.
Visi izveidotie objekti tiks parÄdÄ«ti :
MÅ«sos Varat arÄ« redzÄt manifestus virtuÄlo maŔīnu izveidei ar tÄ«kla diskdziÅiem.
Kubernetes klastera izveides piemÄrs
Pirms pÄriet uz nÄkamo piemÄru, mÄs iztÄ«rÄ«sim iepriekÅ” izveidotos resursus. Lai to izdarÄ«tu, projekta saknÄ palaidiet komandu, lai izdzÄstu OpenStack objektus:
$ 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
PÄc tam palaidiet komandu, lai notÄ«rÄ«tu Selectel VPC API objektus:
$ 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
Abos gadÄ«jumos jums bÅ«s jÄapstiprina visu objektu dzÄÅ”ana:
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
Å is piemÄrs ir direktorijÄ .
Å ajÄ piemÄrÄ tiek izveidots projekts, lietotÄjs ar lomu projektÄ un tiek izveidots viens Kubernetes klasteris. FailÄ vars.tf jÅ«s varat redzÄt noklusÄjuma vÄrtÄ«bas, piemÄram, mezglu skaitu, to raksturlielumus, Kubernetes versiju un daudz ko citu.
Lai izveidotu resursus, lÄ«dzÄ«gi kÄ pirmajÄ piemÄrÄ, vispirms sÄksim moduļu inicializÄciju un moduļu resursu izveidi projekts_ar_lietotÄjuun tad izveido visu pÄrÄjo:
$ 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
Nodosim Kubernetes klasteru izveidi un pÄrvaldÄ«bu caur OpenStack Magnum komponentu. VairÄk par to, kÄ strÄdÄt ar kopu, varat uzzinÄt kÄdÄ no mÅ«su , kÄ arÄ« iekÅ”Ä .
Sagatavojot klasteru, tiks izveidoti diski, virtuÄlÄs maŔīnas un uzstÄdÄ«tas visas nepiecieÅ”amÄs sastÄvdaļas. SagatavoÅ”ana aizÅem apmÄram 4 minÅ«tes, kuru laikÄ Terraform parÄdÄ«s Å”Ädus ziÅojumus:
module.kubernetes_cluster.openstack_containerinfra_cluster_v1.cluster_1: Still creating... (3m0s elapsed)
Kad instalÄÅ”ana ir pabeigta, Terraform ziÅos, ka klasteris ir gatavs, un parÄdÄ«s tÄ 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.
Lai pÄrvaldÄ«tu izveidoto Kubernetes klasteru, izmantojot utilÄ«tu kubectl jums ir jÄiegÅ«st klastera piekļuves fails. Lai to izdarÄ«tu, sava konta projektu sarakstÄ dodieties uz projektu, kas izveidots, izmantojot Terraform:
TÄlÄk sekojiet saitei , kas tiek parÄdÄ«ts zem projekta nosaukuma:
KÄ pieteikÅ”anÄs informÄciju izmantojiet lietotÄjvÄrdu un paroli, kas tika izveidota, izmantojot Terraform. Ja neesi mainÄ«jies vars.tf vai galvenais.tf mÅ«su piemÄrÄ lietotÄjam bÅ«s vÄrds tf_user. MainÄ«gÄ vÄrtÄ«ba ir jÄizmanto kÄ parole TF_VAR_user_password, kas tika norÄdÄ«ts startÄÅ”anas laikÄ pielietot terraformu agrÄk.
Projekta iekÅ”pusÄ jums jÄiet uz cilni Kubernetes:
Å eit ir klasteris, kas izveidots, izmantojot Terraform. LejupielÄdÄt failu kubectl cilnÄ "Piekļuve" varat:
Å ajÄ cilnÄ ir instalÄÅ”anas norÄdÄ«jumi. kubectl un izmantojiet lejupielÄdÄto config.yaml.
PÄc palaiÅ”anas kubectl un vides mainÄ«gÄ iestatÄ«Å”ana KUBECONFIG varat izmantot 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
Klasteru mezglu skaitu var viegli mainīt, izmantojot Terraform.
FailÄ galvenais.tf tiek dota Å”Äda vÄrtÄ«ba:
cluster_node_count = "${var.cluster_node_count}"
Å Ä« vÄrtÄ«ba tiek aizstÄta ar vars.tf:
variable "cluster_node_count" {
default = 2
}
Varat mainÄ«t vai nu noklusÄjuma vÄrtÄ«bu vars.tfvai tieÅ”i norÄdiet vajadzÄ«go vÄrtÄ«bu galvenais.tf:
- cluster_node_count = "${var.cluster_node_count}"
+ cluster_node_count = 3
Lai piemÄrotu izmaiÅas, tÄpat kÄ pirmajÄ piemÄrÄ, izmantojiet komandu pielietot terraformu:
$ env
TF_VAR_sel_account=SEL_ACCOUNT
TF_VAR_sel_token=SEL_TOKEN
TF_VAR_user_password=USER_PASSWORD
terraform apply
Ja mezglu skaits mainÄs, klasteris paliks pieejams. PÄc mezgla pievienoÅ”anas, izmantojot Terraform, varat to izmantot bez papildu konfigurÄcijas:
$ 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
SecinÄjums
Å ajÄ rakstÄ mÄs iepazinÄmies ar galvenajiem veidiem, kÄ strÄdÄt ar izmantojot Terraform. MÄs priecÄsimies, ja izmantosiet oficiÄlo Selectel Terraform pakalpojumu sniedzÄju un sniegsiet atsauksmes.
Par visÄm atrastajÄm Selectel Terraform nodroÅ”inÄtÄja kļūdÄm var ziÅot, izmantojot .
Avots: www.habr.com