Skip to main content

Create and connect instance

Create instance​

Instance is a virtualized hardware resource that configures servers of various instance types. Here is how to create an instance in Virtual Machine(VM):

  1. Go to KakaoCloud Console > Beyond Compute Service > Virtual Machine.

  2. Click the [Create instance] button in the Instance menu.

  3. Enter the required information and click the [Create] button.

    • Network connection after creating an instance can take up to 10 minutes.

    Creating an instance Create instance

    ItemDescription
    ① Basic informationName: Name of the instance
    - Duplicate instance names are allowed within the same project
    - When creating multiple instances, the name of the first instance created is used as the base name for the rest
    ② ImageImage to use
    - Default tab: Images officially provided by Kakao Enterprise
    - My images tab: Images created by the account (see Manage image for details)
    ③ Instance typeSpecifications of the instance
    - See Instance type for details
    ④ VolumeVolume attached to the instance. Root volume is displayed by default, with up to 9 additional custom volumes available if needed.
    - Size: Can be created between 1 and 5,120GB
    - Type: Currently supports SSD only
    - Maximum IOPS: Preset IOPS based on volume size (edit option will be available in the future)

    Delete when instance is deleted: Option to delete the volume when the instance is deleted
    ⚠️ Volumes not selected for this option remain as detached volumes and will continue to incur charges. To avoid charges, manually delete the volumes in the volume list.
    ⑤ Key pairKey pair to apply to the instance
    - Click [Create key pair] to create and assign a new key pair

    ⚠️ The private key file for the created key pair cannot be downloaded again; ensure it is stored securely.
    ⚠️ You cannot connect to the instance without a key pair.
    ⑥ NetworkVPC: Network for the instance
    Network interface: Network interface to be connected when creating the instance; a new network interface can be created or an existing one can be attached
    Subnet: Select a subnet from the network
    - If a new VPC and subnet are needed, they must be created under KakaoCloud Console > VPC
    - A public IP can be assigned after instance creation via Associate public IP

    IP allocation method: Select how the network interface will be assigned an IP
    Security Group: Security group to apply to the instance

    Inbound/Outbound rules
    - Inbound tab: Inbound rules applied to the security group above
    💡 To connect to the instance, you must allow the following inbound ports based on the selected image (required):
    ᄂ Linux: Allow TCP port 22
    ᄂ Windows: Allow TCP port 3389
    ᄂ Windows + MSSQL: Allow TCP ports 3389 and 1433

    - Outbound tab: Outbound rules, allowing all ports and protocols
    ⑦ Advanced settingsUser script: Script to execute user data at instance startup for initial environment setup (runs only on the first start)
    - Enter or upload a user data script or cloud-init command within 16KB
    - Script is copied and executed in /var/lib/cloud/instances
    - To check script execution logs, use the following commands:
    ᄂ Ubuntu: sudo cat /var/log/syslog or sudo journalctl -u cloud-final.service
    ᄂ CentOS: sudo cat /var/log/messages or sudo journalctl -u cloud-final.service

    ⚠️ Entering an incorrect user script or an uncompleted script may cause boot failure.

    CPU multithreading: Option to optimize performance by assigning a single thread per CPU core
    - Recommended to disable for specific workloads like high-performance computing (HPC).
info
  • Instances created on or after January 16, 2023, will have their host names automatically set in the form of the private IP of the primary network interface (e.g., host-100-100-17-22).
  • After an instance is created, it is updated in host-IP format at the networking stage, and hostname may be displayed as the instance name for a while after instance creation.

Connect instance​

Metadata is required to connect to an instance. If there is no 'default security group' of the instance, define an outbound rules for metadata acquisition in the 'custom security group'. For more details, refer to Custom security group.

Connect to Linux instance​

Linux instances can be connected using the SSH command. Check the related explanation by clicking Virtual Machine > Instance menu > [More] icon > Use SSH to connect. Set up the security group according to the OS image and prepare the connection with public/private IP.

OSSecurity group policyAllowed port
LinuxInbound       TCP port 22 (default)

Image. SSH Connection SSH connection

Step 1. Prepare SSH client​

To use SSH commands, an SSH client must be installed beforehand. The requirements for installing an SSH client vary by operating system and are as follows.:

OSPreparation
Linux/macOSInstall an SSH client and use the ssh command in the terminal
WindowsInstall OpenSSH client to use the ssh command in the command prompt (cmd) or install a separate SSH client such as PuTTY

Step 2. Connect via SSH​

Use the SSH command to connect to the instance. Enter the path and file name of your private key file, the username, and the address of the instance you want to connect to.

SSH command
ssh -i {PATH_TO_PRIVATE_KEY} {USERNAME}@{INSTANCE_IP}
CommandDescription
PATH_TO_PRIVATE_KEYPath to the private SSH key
USERNAMEUsername for connecting to the instance
INSTANCE_IPIP associated with the network interface connected to the instance
- Enter either a public or private IP according to the connection environment

Connect to Windows instance​

After establishing an RDP connection, set up a remote PC connection to access the Windows instance. To connect to the instance, configure the security group based on the OS image, and ensure the access environment is prepared to allow connections via public or private IP.

OSSecurity group policyAllowed port
WindowsInbound        TCP Port 3389

Step 1. Connect via RDP​

Proceed with the RDP connection for an instance with Windows OS installed.

info
  • Setting the initial password to connect to an instance may take approximately 20 minutes after requesting instance creation.
  • Access is only possible using the password obtained from the initial key pair file. If the password needs to be changed, the user must do so directly within the operating system (OS).
  • KakaoCloud Console only provides the initially obtained password and does not inform you of any subsequent password changes..
  • There are restrictions on using WSL (Windows Subsystem For Linux) in Windows instances. For Linux, please use a Linux instance.

  1. Go to KakaoCloud Console > Beyond Compute Service > Virtual Machine.

  2. In the Instance menu, select Use RDP to connect from the [More] icon of the instance.

    • The username automatically generated upon instance creation is Administrator.

  3. Click the [Upload key pair] button to upload the key pair (.pem) file associated with the instance to obtain the password.

    • The selected private key is not transmitted to the server.

Step 2. Connect via remote desktop​

To connect to the Windows instance, set up a remote PC (desktop) with the IP address and port number.

  1. Click on Start > Settings > System > Remote Desktop, or enter [Remote Desktop Connection](Microsoft Remote Desktop) in the search bar to launch Remote Desktop.

  2. Enter the public or private IP suitable for the instance's connection and click the [Connect] button.

    • If the instance is configured to use a different port number, add the port number after the IP address. (e.g. 10.0.0.0:1234)

  3. In Enter your credentials, enter the user name and password, click the [OK] button, and then access the respective Windows instance.

caution

If there are instances with the same hostname within the same VPC (Virtual Private Cloud), it may cause errors in certain network functionalities. Be cautious when changing the instance names or directly modifying hostnames to avoid potential issues.