首先

• 今回はAmazon EC2でJenkinsサーバを構築し、Jenkins上でTerraformによるインフラのデプロイをやってみたいと思います。

• 以下のバージョンで動作確認をしています。

Jenkins: 2.361.1
Terraform: 1.3.4

请注意。

• 本記事で構築するアーキテクチャはdemo用のため、本番環境などで利用する際に非機能要件等を考慮した適切な設計が必要です。

• ソースのバージョン管理としてGithubを使用していますが、Githubアカウントをお持ちでない方は別途用意する必要があります。

本記事はJenkinsパイプラインの構築およびJenkinsパイプラインを使ったTerraformデプロイのやり方にフォーカスしていますので、それを実現するための関連AWSリソースの詳細構築手順を割愛させていただきます。

建构图

構成圖的解釋

1. 将Terraform代码推送到远程仓库

1. 通过Jenkins控制台连接并执行作业

1. 从远程仓库克隆Terraform代码到Jenkins服务器

1. 执行terraform plan和terraform apply，将tfstate文件保存到已创建的S3存储桶中

使用Terraform创建AWS验证资源

建立环境

我们将在ap-northeast-1地区创建AWS资源，以实现上述架构。对于未提及的设置项目，将使用默认值。（详细构建步骤已省略）
此外，请使用现有的网络类资源（VPC、子网等），如果可以的话。
※我们准备了以下CloudFormation模板，如果您希望节省构建的工作量，可以使用它。

网络

VPC

インターネットゲートウェイ

ルートテーブル

サブネット

安全组

我是IAM策略和角色。

IAMポリシー

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "ec2:*",
                "s3:*"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

IAMロール

EC2实例

S3桶（用于Terraform的后端）

建立 Jenkins

Jenkins安装

我们将在上述创建的EC2实例上安装Jenkins。虽然也可以使用Docker容器等方法进行构建，但本次我们决定直接在EC2上安装。
通过SSH连接到EC2，根据Jenkins官方网站的安装步骤，执行以下命令。

sudo wget -O /etc/yum.repos.d/jenkins.repo \
    https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
sudo yum upgrade -y
sudo amazon-linux-extras install java-openjdk11 -y
sudo yum install git -y
# Jenkinsのバージョンを指定してインストールする
sudo yum install jenkins-2.361.1 -y
sudo systemctl daemon-reload
sudo systemctl enable jenkins
sudo systemctl start jenkins

Jenkins的初始配置

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

一旦显示初始管理员用户创建页面，请输入所需信息并点击“保存并继续”。

安装Terraform插件

创建Github仓库

由于这次只是演示，我决定创建一个公共存储库。如果要创建私有存储库，需要在Jenkins中注册存储库Clone的访问令牌或SSH密钥，请注意。

创建Jenkinsfile和Terraform代码

Jenkins文件

在Pipeline的tools区块中，写入Jenkins已安装的Terraform插件的“Name”。此外，本次将使用input，在执行terraform plan后，手动批准执行terraform apply。
※此脚本仅用于演示，仅包含基本处理。

pipeline {
  agent any
  options {
    skipDefaultCheckout(true)
  }
  tools {
    terraform "terraform-1.3.4"
  }
  stages{
    stage("clean workspace") {
      steps {
        cleanWs()
      }
    }
    stage("checkout") {
      steps {
        checkout scm
      }
    }
    stage("terraform init") {
      steps {
        sh "terraform init -no-color"   
      }
    }
    stage("terraform plan") {
      steps {
        sh "terraform plan -no-color -out=plan.out"
        input message: "Apply Plan?", ok: "Apply"
      }
    }
    stage("terraform apply") {
      steps {
        sh "terraform apply plan.out -no-color"    
      }
    }
  }
}

土壤形态法的代码

这次为了演示的目的，我们将在main.tf文件中将provider、backend、以及目标资源等全部写在一起，不将tf文件分开。这次我们将使用Terraform创建VPC，并给它添加一个名为”created-by-terraform”的标签。
请指定在环境建设中创建的S3桶的名称作为backend使用的S3桶。

provider "aws" {
  region = "ap-northeast-1"
}

terraform {
  required_version = "~> 1.3.4"
  backend "s3" {
    # your own s3 bucket
    bucket = ""
    region = "ap-northeast-1"
    key    = "terraform.tfstate"
  }
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 4.0"
    }
  }
}

resource "aws_vpc" "main" {
  cidr_block           = "10.0.0.0/16"
  instance_tenancy     = "default"
  enable_dns_support   = true
  enable_dns_hostnames = true
  tags = {
    Name = "created-by-terraform"
  }
}

目录结构

将已经生成的Jenkinsfile和Terraform代码预先准备好，并将它们推送到事先准备好的Github存储库中。目录结构如下所示。

.
├── .gitignore
├── Jenkinsfile
└── main.tf

创建Jenkins任务

将管道设置如下。

执行Jenkins任务

本次将在Jenkinsfile中添加input，并加入手动批准的阶段，但如果不需要手动批准，则可以删除相关部分的input。

最后

这次我在Amazon EC2上搭建了一个Jenkins服务器，并尝试使用Jenkins和Terraform进行基础设施的部署。虽然只是一个简单的演示，但我希望您可以在使用Jenkins运行Terraform时参考一下。最后，别忘了删除这次构建的AWS资源！

请提供更多的上下文，这样我才能为您提供一个准确的中文翻译。

• Installing Jenkins | jenkins.io

• Pipeline | jenkins.io

Providers – aws | registry.terraform.io