構成管理のためにTerraformでAnsibleを使用する方法

著者は、 Write for DOnations プログラムの一環として、 Free and Open SourceFundを選択して寄付を受け取りました。

序章

Ansible は、 playbooks を実行する構成管理ツールです。これは、指定されたターゲットサーバー上でYAMLで記述されたカスタマイズ可能なアクションのリストです。ソフトウェアのインストールと更新、ユーザーの作成と削除、システムサービスの構成など、すべてのブートストラップ操作を実行できます。そのため、デフォルトで空白で作成されるTerraformを使用してデプロイするサーバーを起動するのに適しています。

AnsibleとTerraformは、インフラストラクチャとソフトウェアの展開のさまざまなフェーズを解決するため、競合するソリューションではありません。 Terraformを使用すると、アプリケーションを実行するハードウェアを含む、システムのインフラストラクチャを定義および作成できます。逆に、Ansibleは、提供されたサーバーインスタンスでプレイブックを実行することにより、ソフトウェアを構成およびデプロイします。作成直後にプロビジョニングされたリソースTerraformでAnsibleを実行すると、リソースをユースケースで使用できるようにすることができます。また、デプロイされたすべてのサーバーに同じアクションが適用されるため、メンテナンスとトラブルシューティングが容易になります。

このチュートリアルでは、Terraformを使用してドロップレットをデプロイし、作成直後にAnsibleを使用してドロップレットをブートストラップします。リソースがデプロイされるときに、Terraformから直接Ansibleを呼び出します。また、構成でTerraformのremote-execおよびlocal-execプロビジョナーを使用して競合状態を導入することは避けます。これにより、セットアップを開始する前にDropletの展開が完全に完了します。

前提条件

DigitalOceanパーソナルアクセストークン。DigitalOceanコントロールパネルから作成できます。手順については、DigitalOcean製品ドキュメントパーソナルアクセストークンの作成方法を参照してください。
ローカルマシンにインストールされたTerraformと、DigitalOceanプロバイダーでセットアップされたプロジェクト。 DigitalOcean チュートリアルでTerraformを使用する方法のステップ1およびステップ2を完了し、プロジェクトフォルダーにterraform-ansibleではなく名前を付けてください。 loadbalance。
Ansibleがマシンにインストールされています。 Ubuntu 20.04の場合は、 Ubuntu20.04チュートリアルにAnsibleをインストールして構成する方法の最初のステップを完了します。 Ansibleの詳細については、このAnsibleを使用した構成管理の概要の記事をお読みください。

注：このチュートリアルは、Terraform1.0.2で特別にテストされています。

ステップ1—液滴を定義する

このステップでは、後でAnsibleプレイブックを実行するドロップレットを定義します。これにより、ApacheWebサーバーがセットアップされます。

前提条件の一部として作成したterraform-ansibleディレクトリにいると仮定して、Dropletリソースを定義し、countを指定してそのコピーを3つ作成し、それらのIPアドレスを出力します。 droplets.tfという名前のファイルに定義を保存します。次のコマンドを実行して、編集用に作成して開きます。

nano droplets.tf

次の行を追加します。

〜/ terraform-ansible / droplets.tf

resource "digitalocean_droplet" "web" {
  count  = 3
  image  = "ubuntu-18-04-x64"
  name   = "web-${count.index}"
  region = "fra1"
  size   = "s-1vcpu-1gb"

  ssh_keys = [
      data.digitalocean_ssh_key.terraform.id
  ]
}

output "droplet_ip_addresses" {
  value = {
    for droplet in digitalocean_droplet.web:
    droplet.name => droplet.ipv4_address
  }
}

ここでは、リージョンfra1のCPUコアに1GBのRAMを搭載したUbuntu18.04を実行するDropletリソースを定義します。 Terraformは、前提条件で定義したSSHキーをアカウントからプルし、ssh_keysに渡された指定された一意のIDリスト要素でプロビジョニングされたドロップレットに追加します。 countパラメータが設定されているため、Terraformはドロップレットを3回デプロイします。その後の出力ブロックには、3つのドロップレットのIPアドレスが表示されます。 loop はドロップレットのリストをトラバースし、インスタンスごとに、その名前とIPアドレスをペアにして、結果のマップに追加します。

完了したら、ファイルを保存して閉じます。

これで、Terraformが展開するドロップレットが定義されました。次のステップでは、デプロイされた3つのドロップレットのそれぞれで実行され、ApacheWebサーバーをデプロイするAnsibleプレイブックを作成します。後でTerraformコードに戻り、Ansibleとの統合を追加します。

ステップ2—AnsiblePlaybookを作成する

次に、新しいユーザーの作成やインストールされたパッケージのアップグレードなど、サーバーの初期セットアップタスクを実行するAnsibleプレイブックを作成します。ターゲットホストで実行されるアクションの単位であるtasksを記述して、Ansibleに何をすべきかを指示します。タスクは、組み込み関数を使用することも、実行するカスタムコマンドを指定することもできます。初期設定のタスクに加えて、Apache Webサーバーをインストールし、そのmod_rewriteモジュールを有効にします。

プレイブックを作成する前に、DigitalOceanアカウントのSSHキーに対応する公開SSHキーと秘密SSHキーが、TerraformとAnsibleを実行しているマシンで使用可能でアクセス可能であることを確認してください。 Linuxでそれらを保存するための一般的な場所は、~/.sshです（ただし、他の場所に保存することもできます）。

注： Linuxでは、秘密鍵ファイルに適切な権限があることを確認する必要があります。次のコマンドを実行して設定できます。

chmod 600 your_private_key_location

秘密鍵の変数はすでに定義されているため、公開鍵の場所に1つ追加するだけで済みます。

provider.tfを開いて、次のコマンドを実行して編集します。

nano provider.tf

次の行を追加します。

〜/ terraform-ansible / Provider.tf

terraform {
  required_providers {
    digitalocean = {
      source = "digitalocean/digitalocean"
      version = "~> 2.0"
    }
  }
}

variable "do_token" {}
variable "pvt_key" {}
variable "pub_key" {}

provider "digitalocean" {
  token = var.do_token
}

data "digitalocean_ssh_key" "terraform" {
  name = "terraform"
}

完了したら、ファイルを保存して閉じます。

pub_key変数が定義されたら、Ansibleプレイブックの作成を開始します。 apache-install.ymlというファイルに保存します。編集のために作成して開きます。

nano apache-install.yml

徐々にプレイブックを作成していきます。まず、プレイブックを実行するホスト、その名前、およびタスクをrootとして実行するかどうかを定義する必要があります。次の行を追加します。