Terraform プロバイダー Selectel

Selectel と連携するための公式 Terraform プロバイダーを立ち上げました。 この製品を使用すると、ユーザーはコードとしてのインフラストラクチャ手法を通じてリソース管理を完全に実装できます。

プロバイダーは現在サービス リソース管理をサポートしています 「仮想プライベートクラウド」 （以下、VPCといいます）。 将来的には、Selectel が提供する他のサービスにもリソース管理を追加する予定です。

すでにご存知のとおり、VPC サービスは OpenStack 上に構築されています。 ただし、OpenStack はパブリック クラウドにサービスを提供するためのネイティブ ツールを提供していないため、複雑な複合オブジェクトの管理を簡素化し、作業をより便利にする一連の追加 API に不足している機能を実装しました。 OpenStack で利用可能な機能の一部は直接使用できませんが、 私たちのAPI.

Selectel Terraform プロバイダーには、次の VPC リソースを管理する機能が含まれています。

• プロジェクトとその割り当て。
• ユーザー、その役割、トークン。
• クロスリージョンおよび VRRP を含むパブリック サブネット。
• ソフトウェアライセンス。

プロバイダーは、パブリック Go ライブラリを使用して VPC API を操作します。 ライブラリとプロバイダ自体は両方ともオープンソースであり、開発は Github で行われます。

• ライブラリリポジトリ Go-selfpcclient,
• プロバイダリポジトリ Terraform プロバイダー Selectel.

仮想マシン、ディスク、Kubernetes クラスターなどの他のクラウド リソースを管理するには、OpenStack Terraform プロバイダーを使用できます。 両方のプロバイダーの公式ドキュメントは、次のリンクから入手できます。

• Selectel リソースのドキュメント: Terraform プロバイダー Selectel,
• OpenStack リソースのドキュメント: Terraform プロバイダー OpenStack.

はじめに

始めるには、Terraform をインストールする必要があります (インストール パッケージへの手順とリンクは、次の場所にあります)。 公式サイト).

プロバイダーが動作するには、Selectel API キーが必要です。このキーは、 アカウントコントロールパネル.

Selectel を操作するためのマニフェストは、Terraform を使用するか、Github リポジトリで入手可能な既製のサンプルのセットを使用して作成されます。 テラフォームの例.

例を含むリポジトリは XNUMX つのディレクトリに分かれています。

• モジュール、パラメータのセットを入力として受け取り、リソースの小さなセットを管理する小さな再利用可能なモジュールが含まれています。
• 例、相互接続されたモジュールの完全なセットの例が含まれています。

Terraform をインストールし、Selectel API キーを作成し、例に慣れたら、実践的な例に進みましょう。

ローカルディスクを使用したサーバーの作成例

プロジェクト、ロールを持つユーザー、およびローカル ディスクを持つ仮想マシンを作成する例を見てみましょう。 terraform-examples/examples/vpc/server_local_root_disk.

ファイル内 vars.tf モジュールを呼び出すときに使用されるすべてのパラメータが説明されています。 それらの一部にはデフォルト値があります。たとえば、サーバーはゾーン内に作成されます。 en-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"
}

ファイル内 main.tf Selectel プロバイダーが初期化されます。

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

このファイルには、サーバーにインストールされる SSH キーのデフォルト値も含まれています。

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

必要に応じて、別の公開キーを指定できます。 キーはファイル パスとして指定する必要はなく、値を文字列として追加することもできます。

このファイルのさらに奥でモジュールが起動されます プロジェクトとユーザー и サーバーローカルルートディスク、必要なリソースを管理します。

これらのモジュールをさらに詳しく見てみましょう。

プロジェクトとロールを持つユーザーの作成

最初のモジュールは、プロジェクトと、そのプロジェクト内のロールを持つユーザーを作成します。 terraform-examples/モジュール/vpc/project_with_user.

作成されたユーザーは OpenStack にログインし、そのリソースを管理できるようになります。 このモジュールはシンプルで、次の XNUMX つのエンティティのみを管理します。

• selectel_vpc_project_v2、
• selectel_vpc_user_v2、
• selectel_vpc_role_v2。

ローカルディスクを使用した仮想サーバーの作成

XNUMX 番目のモジュールは、ローカル ディスクを使用してサーバーを作成するために必要な 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 サービスでは、ほとんどの公開イメージは週に XNUMX 回自動的に更新され、同時にそれらのイメージも更新されます。 id も変わります。 これは、OpenStack コンポーネントである Glance の特殊性によるもので、画像は不変のエンティティと見なされます。

引数として を持つ既存のサーバーまたはディスクを作成または変更する場合 画像ID 中古 id パブリック イメージを作成し、そのイメージが更新された後に Terraform マニフェストを再度実行すると、サーバーまたはディスクが再作成されます。 引数の使用 無視する_変更 そのような状況を回避できます。

注: 引数 無視する_変更 かなり昔に Terraform に登場しました。 プル#2525.

引数 無視_サイズ変更_確認 ローカル ディスク、コア、またはサーバー メモリのサイズを正常に変更するために必要です。 このような変更は、リクエストを使用して OpenStack Nova コンポーネントを通じて行われます。 リサイズ。 リクエスト後のデフォルトの Nova リサイズ サーバーをステータスにします verify_resize そしてユーザーからの追加の確認を待ちます。 ただし、この動作は、Nova がユーザーからの追加アクションを待たないよう変更できます。

指定された引数により、Terraform はステータスを待機しなくなります。 verify_resize サーバーのパラメータを変更した後にサーバーがアクティブな状態になるように準備してください。 この引数は、OpenStack Terraform プロバイダーのバージョン 1.10.0 から利用できます。 プル#422.

リソースの作成

マニフェストを実行する前に、この例では XNUMX つの異なるプロバイダーが起動されており、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_account Selectel アカウント番号とともに;
• sel_token Selectel API のキーを使用します。
• ユーザーのパスワード OpenStack ユーザーのパスワードを使用します。

最初の XNUMX つの変数の値は次から取得する必要があります。 コントロールパネル.

最後の変数については、任意のパスワードを思いつくことができます。

モジュールを使用するには、値を置き換える必要があります 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

リソースを作成するときは、作成されたサーバーがアクセスできる外部 IP アドレスを含む Terraform 出力に注意してください。

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

作成した仮想マシンは、指定した IP を使用して SSH 経由で操作できます。

リソースの編集

Terraform を使用してリソースを作成するだけでなく、リソースを変更することもできます。

たとえば、パラメータの値を変更して、サーバーのコアとメモリの数を増やしてみましょう。 サーバー_vcpu и サーバー_ram_mb ファイル内 例/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.

この例では、プロジェクト、プロジェクト内のロールを持つユーザーを作成し、XNUMX つの 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 を通じて作成されたプロジェクトに移動します。

次に、次のようなリンクをたどります xxxxxx.selvpc.ruこれはプロジェクト名の下に表示されます。

ログイン情報には、Terraform を通じて作成したユーザー名とパスワードを使用します。 不正行為をしていない場合 vars.tf または main.tf この例では、ユーザーの名前は次のとおりです。 tf_user。 変数の値をパスワードとして使用する必要があります TF_VAR_ユーザーパスワード起動時に指定された テラフォーム適用 以前。

プロジェクト内でタブに移動する必要があります Kubernetes:

これは、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 を使用して簡単に変更できます。
ファイル内 main.tf 次の値が指定されます。

cluster_node_count = "${var.cluster_node_count}"

この値は次から置き換えられます。 vars.tf:

variable "cluster_node_count" {
default = 2
}

どちらかのデフォルト値を変更できます。 vars.tf、または必要な値を直接指定します。 main.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の問題.

出所： habr.com