Community

»NAVER CLOUD PLATFORM Builder

Type: ncloud Artifact BuilderId: ncloud.server.image

The ncloud builder allows you to create server images using the NAVER Cloud Platform.

»Configuration Reference

»Required:

»Optional:

  • server_product_code (string) - Product (spec) code to create.

  • vpc_no (string) - The ID of the VPC where you want to place the Server Instance. If this field is left blank, Packer will try to get the VPC ID from the subnet_no. (You are required to least one between two parameters if u want using VPC environment: vpc_no or subnet_no)

  • subnet_no (string) - The ID of the Subnet where you want to place the Server Instance. If this field is left blank, Packer will try to get the Public Subnet ID from the vpc_no.

  • member_server_image_no (string) - Previous image code. If there is an image previously created, it can be used to create a new image. (server_image_product_code is required if not specified)

  • server_image_name (string) - Name of an image to create.

  • server_image_description (string) - Description of an image to create.

  • block_storage_size (number) - You can add block storage ranging from 10 GB to 2000 GB, in increments of 10 GB.

  • access_control_group_no (string) - This is used to allow winrm access when you create a Windows server. An ACG that specifies an access source (0.0.0.0/0) and allowed port (5985) must be created in advance if you use CLASSIC env. If this field is left blank, Packer will create temporary ACG for automatically in VPC environment.

  • user_data (string) - User data to apply when launching the instance. Note that you need to be careful about escaping characters due to the templates being JSON. It is often more convenient to use user_data_file, instead. Packer will not automatically wait for a user script to finish before shutting down the instance this must be handled in a provisioner.

  • user_data_file (string) - Path to a file that will be used for the user data when launching the instance.

  • region (string) - Name of the region where you want to create an image. (default: Korea)

    • values: Korea / US-West / HongKong / Singapore / Japan / Germany

»Basic Example

Here is a basic example for windows server.

variable "access_key" {
  type    = string
  # default = "your_access_key"
}

variable "secret_key" {
  type    = string
  # default = "your_secret_key"
}

locals {
  timestamp = regex_replace(timestamp(), "[- TZ:]", "")
}

source "ncloud" "example-windows" {
  access_key                            = "${var.access_key}"
  secret_key                            = "${var.secret_key}"
  server_image_product_code             = "SW.VSVR.OS.WND64.WND.SVR2016EN.B100" // for VPC environment.
  # server_image_product_code           = "SPSW0WINNTEN0016"  // for CLASSIC environment.
  server_image_name                     = "packer-${local.timestamp}"
  server_image_description              = "server image description"
  user_data                             = "CreateObject(\"WScript.Shell\").run(\"cmd.exe /c powershell Set-ExecutionPolicy RemoteSigned & winrm quickconfig -q & sc config WinRM start= auto & winrm set winrm/config/service/auth @{Basic=\"\"true\"\"} & winrm set winrm/config/service @{AllowUnencrypted=\"\"true\"\"} & winrm get winrm/config/service\")"
  region                                = "Korea"
  vpc_no                                = "{{YOUR_VPC_ID}}" // Remove this if you use CLASSIC environment.
  subnet_no                             = "{{YOUR_SUBNET_ID}}" // Remove this if you use CLASSIC environment.
  communicator                          = "winrm"
  winrm_username                        = "Administrator"
  # access_control_group_no             = "{{YOUR_ACG_ID}}" // Specific ACG ID allowed port (5985) if you use CLASSIC environment.
}

build {
  sources = ["source.ncloud.example-windows"]

  provisioner "powershell" {
    inline = [
      "Write-Output 1,2,3 | Measure-Object"
    ]
  }
}
variable "access_key" {  type    = string  # default = "your_access_key"}
variable "secret_key" {  type    = string  # default = "your_secret_key"}
locals {  timestamp = regex_replace(timestamp(), "[- TZ:]", "")}
source "ncloud" "example-windows" {  access_key                            = "${var.access_key}"  secret_key                            = "${var.secret_key}"  server_image_product_code             = "SW.VSVR.OS.WND64.WND.SVR2016EN.B100" // for VPC environment.  # server_image_product_code           = "SPSW0WINNTEN0016"  // for CLASSIC environment.  server_image_name                     = "packer-${local.timestamp}"  server_image_description              = "server image description"  user_data                             = "CreateObject(\"WScript.Shell\").run(\"cmd.exe /c powershell Set-ExecutionPolicy RemoteSigned & winrm quickconfig -q & sc config WinRM start= auto & winrm set winrm/config/service/auth @{Basic=\"\"true\"\"} & winrm set winrm/config/service @{AllowUnencrypted=\"\"true\"\"} & winrm get winrm/config/service\")"  region                                = "Korea"  vpc_no                                = "{{YOUR_VPC_ID}}" // Remove this if you use CLASSIC environment.  subnet_no                             = "{{YOUR_SUBNET_ID}}" // Remove this if you use CLASSIC environment.  communicator                          = "winrm"  winrm_username                        = "Administrator"  # access_control_group_no             = "{{YOUR_ACG_ID}}" // Specific ACG ID allowed port (5985) if you use CLASSIC environment.}
build {  sources = ["source.ncloud.example-windows"]
  provisioner "powershell" {    inline = [      "Write-Output 1,2,3 | Measure-Object"    ]  }}

Here is a basic example for linux server.

variable "access_key" {
  type    = string
  # default = "your_access_key"
}

variable "secret_key" {
  type    = string
  # default = "your_secret_key"
}

locals {
  timestamp = regex_replace(timestamp(), "[- TZ:]", "")
}

source "ncloud" "example-linux" {
  access_key                = "${var.access_key}"
  secret_key                = "${var.secret_key}"
  server_image_product_code = "SW.VSVR.OS.LNX64.CNTOS.0708.B050" // for VPC environment.
  # server_image_product_code = "SPSW0LINUX000044" // for CLASSIC environment.
  server_image_name         = "packer-${local.timestamp}"
  server_image_description  = "server image description"
  region                    = "Korea"
  vpc_no                    = "{{YOUR_VPC_ID}}" // Remove this if you use CLASSIC environment.
  subnet_no                 = "{{YOUR_SUBNET_ID}}" // Remove this if you use CLASSIC environment.
  communicator              = "ssh"
  ssh_username              = "root"
}

build {
  sources = ["source.ncloud.example-linux"]

  provisioner "shell" {
    inline = [
      "echo Connected via SSM at '${build.User}@${build.Host}:${build.Port}'"
    ]
  }
}
variable "access_key" {  type    = string  # default = "your_access_key"}
variable "secret_key" {  type    = string  # default = "your_secret_key"}
locals {  timestamp = regex_replace(timestamp(), "[- TZ:]", "")}
source "ncloud" "example-linux" {  access_key                = "${var.access_key}"  secret_key                = "${var.secret_key}"  server_image_product_code = "SW.VSVR.OS.LNX64.CNTOS.0708.B050" // for VPC environment.  # server_image_product_code = "SPSW0LINUX000044" // for CLASSIC environment.  server_image_name         = "packer-${local.timestamp}"  server_image_description  = "server image description"  region                    = "Korea"  vpc_no                    = "{{YOUR_VPC_ID}}" // Remove this if you use CLASSIC environment.  subnet_no                 = "{{YOUR_SUBNET_ID}}" // Remove this if you use CLASSIC environment.  communicator              = "ssh"  ssh_username              = "root"}
build {  sources = ["source.ncloud.example-linux"]
  provisioner "shell" {    inline = [      "echo Connected via SSM at '${build.User}@${build.Host}:${build.Port}'"    ]  }}

»Requirements for creating Windows images

You should include the following code in the Packer configuration file for provision when creating a Windows server.

  "builders": [
    {
      "type": "ncloud",
      ...
      "user_data":
        "CreateObject(\"WScript.Shell\").run(\"cmd.exe /c powershell Set-ExecutionPolicy RemoteSigned & winrm set winrm/config/service/auth @{Basic=\"\"true\"\"} & winrm set winrm/config/service @{AllowUnencrypted=\"\"true\"\"} & winrm quickconfig -q & sc config WinRM start= auto & winrm get winrm/config/service\")",
      "communicator": "winrm",
      "winrm_username": "Administrator"
    }
  ],
  "provisioners": [
    {
      "type": "powershell",
      "inline": [
        "$Env:SystemRoot\\System32\\Sysprep\\Sysprep.exe /oobe /generalize /shutdown /quiet /mode:vm \"/unattend:C:\\Program Files (x86)\\NBP\\nserver64.xml\" "
      ]
    }
  ]
  "builders": [    {      "type": "ncloud",      ...      "user_data":        "CreateObject(\"WScript.Shell\").run(\"cmd.exe /c powershell Set-ExecutionPolicy RemoteSigned & winrm set winrm/config/service/auth @{Basic=\"\"true\"\"} & winrm set winrm/config/service @{AllowUnencrypted=\"\"true\"\"} & winrm quickconfig -q & sc config WinRM start= auto & winrm get winrm/config/service\")",      "communicator": "winrm",      "winrm_username": "Administrator"    }  ],  "provisioners": [    {      "type": "powershell",      "inline": [        "$Env:SystemRoot\\System32\\Sysprep\\Sysprep.exe /oobe /generalize /shutdown /quiet /mode:vm \"/unattend:C:\\Program Files (x86)\\NBP\\nserver64.xml\" "      ]    }  ]

»Note

  • You can only create as many public IP addresses as the number of server instances you own. Before running Packer, please make sure that the number of public IP addresses previously created is not larger than the number of server instances (including those to be used to create server images).
  • When you forcibly terminate the Packer process or close the terminal (command) window where the process is running, the resources may not be cleaned up as the Packer process no longer runs. In this case, you should manually clean up the resources associated with the process.