---
description: |
  The ncloud builder allows you to create server images using the NAVER Cloud
  Platform.
page_title: Naver Cloud Platform - Builders
sidebar_title: NAVER Cloud
---

# 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](https://www.ncloud.com/).

## Configuration Reference

### Required:

- `ncloud_access_key` (string) - User's access key. Go to [\[Account
  Management &gt; Authentication
  Key\]](https://www.ncloud.com/mypage/manage/authkey) to create and view
  your authentication key.

- `ncloud_secret_key` (string) - User's secret key paired with the access
  key. Go to [\[Account Management &gt; Authentication
  Key\]](https://www.ncloud.com/mypage/manage/authkey) to create and view
  your authentication key.

- `server_image_product_code` (string) - Product code of an image to create.
  (member_server_image_no is required if not specified)

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

### Optional:

- `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_configuration_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.

- `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

## Sample code of template.json

Here is a basic example for windows server.

    {
      "variables": {
        "ncloud_access_key": "FRxhOQRNjKVMqIz3sRLY",
        "ncloud_secret_key": "xd6kTO5iNcLookBx0D8TDKmpLj2ikxqEhc06MQD2"
      },
      "builders": [
        {
          "type": "ncloud",
          "access_key": "{{user `ncloud_access_key`}}",
          "secret_key": "{{user `ncloud_secret_key`}}",

          "server_image_product_code": "SPSW0WINNTEN0016",
          "server_product_code": "SPSVRSSD00000002",
          "server_image_name": "packer-test {{timestamp}}",
          "server_image_description": "server 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": "US-West",
          "communicator": "winrm",
          "winrm_username": "Administrator",
          "access_control_group_configuration_no" : 4964
        }
      ]
    }

-> **Warning:** Please note that if you're setting up WinRM for provisioning, you'll probably want to turn it off or restrict its permissions as part of a shutdown script at the end of Packer's provisioning process. For more details on the why/how, check out this useful blog post and the associated code:
https://cloudywindows.io/post/winrm-for-provisioning-close-the-door-on-the-way-out-eh/

Here is a basic example for linux server.

    {
      "variables": {
        "ncloud_access_key": "FRxhOQRNjKVMqIz3sRLY",
        "ncloud_secret_key": "xd6kTO5iNcLookBx0D8TDKmpLj2ikxqEhc06MQD2"
      },
      "builders": [
        {
          "type": "ncloud",
          "access_key": "{{user `ncloud_access_key`}}",
          "secret_key": "{{user `ncloud_secret_key`}}",

          "server_image_product_code": "SPSW0LINUX000044",
          "server_product_code": "SPSVRSSD00000002",
          "server_image_name": "packertest2",
          "server_image_description": "server image description",
          "region": "US-West",
          "communicator": "ssh",
          "ssh_username": "root"
        }
      ]
    }

## 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\" "
          ]
        }
      ]

## 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.
