Quick Deploy vm ESXi with Terraform

Hello everyone, my name is Ivan and I am an alcoholic system administrator (OPS).

I would like to tell you how I deploy virtual machines on ESXi without vCenter using Terraform.

Quite often, you have to deploy / recreate virtual machines in order to test this or that application. Due to laziness, I thought about automating the process. My search led me to a wonderful product of the company hashicorp, terra form.

I think many people know what Terraform is, and who doesn’t know, this is an application for managing any cloud, infrastructure or service using the IasC concept (Infrastructure as code).

I use ESXi as my virtualization environment. Quite simple, convenient and reliable.
I anticipate a question.

Why terraform when you can use vCenter Server?

You can of course, but. Firstly, this is an additional license, secondly, this product is very resource-intensive and simply does not fit on my home server, and thirdly, the ability to upgrade skills.

The Intel NUC platform acts as a server:

CPU: 2 CPUs x Intel(R) Core(TM) i3-4010U CPU @ 1.70GHz
RAM: 8Gb
HDD: 500Gb
ESXi version: ESXi-6.5.0-4564106-standard (VMware, Inc.)

And so, first things first.

For now, let's set up esxi, namely, open the VNC port in the firewall settings.

By default, the file is write-protected. We carry out the following manipulations:

chmod 644 /etc/vmware/firewall/service.xml
chmod +t /etc/vmware/firewall/service.xml
vi /etc/vmware/firewall/service.xml

append the following block to the end of the file:

<service id="1000">
  <id>packer-vnc</id>
  <rule id="0000">
    <direction>inbound</direction>
    <protocol>tcp</protocol>
    <porttype>dst</porttype>
    <port>
      <begin>5900</begin>
      <end>6000</end>
    </port>
  </rule>
  <enabled>true</enabled>
  <required>true</required>
</service>

Exit, save. Change the rights back and restart the service:

chmod 444 /etc/vmware/firewall/service.xml
esxcli network firewall refresh

Actual until the host is rebooted. After that, this manipulation will have to be repeated.

Further, I will carry out all the work in a virtual machine on the same server.

Features:

OS: Centos 7 x86_64 minimal
RAM: 1GB
HDD: 20GB
Selinux: disable
firewalld: disable

Next, we need packer, also a product of HashiCorp.

It is needed to automatically assemble the "golden" image. which we will use in the future.

yum install unzip git -y
curl -O https://releases.hashicorp.com/packer/1.5.5/packer_1.5.5_linux_amd64.zip
unzip packer_1.5.5_linux_amd64.zip -d /usr/bin && rm -rf packer_1.5.5_linux_amd64.zip
packer version
Packer v1.5.5

On the move packer version an error may occur, since RedHat-based may contain a package with the same name.

which -a packer
/usr/sbin/packer

For the solution, you can create a symlink, or use an absolute path /usr/bin/packer.

Now we need ovftool download link. Download, put on the server and install:

chmod +x VMware-ovftool-4.4.0-15722219-lin.x86_64.bundle
./VMware-ovftool-4.4.0-15722219-lin.x86_64.bundle
Extracting VMware Installer...done.
You must accept the VMware OVF Tool component for Linux End User
License Agreement to continue.  Press Enter to proceed.
VMWARE END USER LICENSE AGREEMENT
Do you agree? [yes/no]:yes
The product is ready to be installed.  Press Enter to begin
installation or Ctrl-C to cancel. 
Installing VMware OVF Tool component for Linux 4.4.0
    Configuring...
[######################################################################] 100%
Installation was successful.

We move on.

On the gith I prepared everything you need.

git clone https://github.com/letnab/create-and-deploy-esxi.git && cd create-and-deploy-esxi

To folder iso you need to put the distribution kit of the operating system. In my case, this is centos 7.

You also need to edit the file. centos-7-base.json:

variables: ΡƒΠΊΠ°Π·Π°Ρ‚ΡŒ свои Π΄Π°Π½Π½Ρ‹Π΅ для ΠΏΠΎΠ΄ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΡ
iso_urls: ΡƒΠΊΠ°Π·Π°Ρ‚ΡŒ Π°ΠΊΡ‚ΡƒΠ°Π»ΡŒΠ½Ρ‹ΠΉ
iso_checksum: чСксумма вашСго ΠΎΠ±Ρ€Π°Π·Π° 

After all the changes, run the assembly:

/usr/bin/packer build centos-7-base.json

If everything is configured and specified correctly, then you will see a picture of the automatic installation of the operating system. This process takes me 7-8 minutes.

After successful completion in the folder output-packer-centos7-x86_64 ova file will be located.

Install Terraform:

curl -O https://releases.hashicorp.com/terraform/0.12.24/terraform_0.12.24_linux_amd64.zip
unzip terraform_0.12.24_linux_amd64.zip -d /usr/bin/ && rm -rf terraform_0.12.24_linux_amd64.zip
terraform version
Terraform v0.12.24

Since Terraform does not have a provider for ESXi, you need to build one.

We put go:

cd /tmp
curl -O https://dl.google.com/go/go1.14.2.linux-amd64.tar.gz
tar -C /usr/local -xzf go1.14.2.linux-amd64.tar.gz && rm -rf go1.14.2.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin
go version
go version go1.14.2 linux/amd64

Next, we collect the provider:

go get -u -v golang.org/x/crypto/ssh
go get -u -v github.com/hashicorp/terraform
go get -u -v github.com/josenk/terraform-provider-esxi
export GOPATH="$HOME/go"
cd $GOPATH/src/github.com/josenk/terraform-provider-esxi
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -ldflags '-w -extldflags "-static"' -o terraform-provider-esxi_`cat version`
cp terraform-provider-esxi_`cat version` /usr/bin

We are at the finish line. Let's go roll out our image.

Let's go to the folder:

cd /root/create-and-deploy-esxi/centos7

First of all, edit the file variables.tf. You need to specify a connection to the ESXi server.

In file network_config.cfg contain the network settings of the future virtual machine. Change to your needs and run the one-liner:

sed -i -e '2d' -e '3i "network": "'$(gzip < network_config.cfg| base64 | tr -d 'n')'",' metadata.json

Well, in the file main.tf change the path to the ova file to your own, if different.

The moment of truth.

terraform init
Initializing the backend...

Initializing provider plugins...

The following providers do not have any version constraints in configuration,
so the latest version was installed.

To prevent automatic upgrades to new major versions that may contain breaking
changes, it is recommended to add version = "..." constraints to the
corresponding provider blocks in configuration, with the constraint strings
suggested below.

* provider.esxi: version = "~> 1.6"
* provider.template: version = "~> 2.1"

Terraform has been successfully initialized!

You may now begin working with Terraform. Try running "terraform plan" to see
any changes that are required for your infrastructure. All Terraform commands
should now work.

If you ever set or change modules or backend configuration for Terraform,
rerun this command to reinitialize your working directory. If you forget, other
commands will detect it and remind you to do so if necessary.

terraform plan
Refreshing Terraform state in-memory prior to plan...
The refreshed state will be used to calculate this plan, but will not be
persisted to local or remote state storage.

data.template_file.Default: Refreshing state...
data.template_file.network_config: Refreshing state...

------------------------------------------------------------------------

An execution plan has been generated and is shown below.
Resource actions are indicated with the following symbols:
  + create

Terraform will perform the following actions:

  # esxi_guest.Default will be created
  + resource "esxi_guest" "Default" {
      + boot_disk_size         = (known after apply)
      + disk_store             = "datastore1"
      + guest_name             = "centos7-test"
      + guest_shutdown_timeout = (known after apply)
      + guest_startup_timeout  = (known after apply)
      + guestinfo              = {
          + "metadata"          = "base64text"
          + "metadata.encoding" = "gzip+base64"
          + "userdata"          = "base64text"
          + "userdata.encoding" = "gzip+base64"
        }
      + guestos                = (known after apply)
      + id                     = (known after apply)
      + ip_address             = (known after apply)
      + memsize                = "1024"
      + notes                  = (known after apply)
      + numvcpus               = (known after apply)
      + ovf_properties_timer   = (known after apply)
      + ovf_source             = "/root/create-and-deploy-esxi/output-packer-centos7-x86_64/packer-centos7-x86_64.ova"
      + power                  = "on"
      + resource_pool_name     = (known after apply)
      + virthwver              = (known after apply)

      + network_interfaces {
          + mac_address     = (known after apply)
          + nic_type        = (known after apply)
          + virtual_network = "VM Network"
        }
    }

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

------------------------------------------------------------------------

Note: You didn't specify an "-out" parameter to save this plan, so Terraform
can't guarantee that exactly these actions will be performed if
"terraform apply" is subsequently run.

Finish:

terraform apply

If everything is done correctly, then in 2-3 minutes a new virtual machine will be deployed from the previously made image.

The uses for all of this are limited only by your imagination.

I just wanted to share the best practices and show the main points when working with these products.

Thank you!

PS: I will be glad to constructive criticism.

Source: habr.com

Add a comment