The page has been translated by Gen AI.

VM Deployment

Users can register/manage VM deployments through the DevOps Console.
Before registering a VM deployment, there must be an available VM server group (VM server group), and registered VM deployments can be used in the build pipeline (Deploy to VM).
Users can distinguish deployment methods by icon.

  • (SSH method) VM deployment (SSH method) VM deployment
  • (Agent method) VM deployment (Agent method) VM deployment
Note
Difference by deployment method: Table. SSH method vs Agent method

Starting VM Deployment

To start a VM deployment, follow these steps.

  1. Click the Project card on the Main page. Move to the Project Dashboard page.
  2. Click the Build/Deployment > VM Deployment menu on the left. Move to the VM Deployment page.
ItemDescription
Deployment group nameDisplays the name of the deployment group.
VM deployment result(Success)/(Total): Displays the number of VM servers that are deployment targets and the number of VM servers that have been successfully deployed.
  • Green: All successes
  • Blue: In progress
  • Red: Partial failure
  • Gray: Ready, paused
Deployment timeDisplays the deployment time.
DeleteDeletes the VM deployment.
Table. VM deployment display items

Adding VM Deployment

To add a VM deployment, follow these steps.

  1. Click the Project card on the Main page. Move to the Project Dashboard page.
  2. Click the Build/Deployment > VM Deployment menu on the left. Move to the VM Deployment page.
  3. Click the Add VM Deployment button at the top right of the VM Deployment page. The Add VM Deployment popup window opens.
  4. Enter information in the Add VM Deployment popup window and click the Save button.
ItemDescription
Deployment groupEnter the deployment group name.
Execution methodSelect the execution method.
  • File transfer and command execution: Select this for general VM file deployment.
  • Command execution only: Select this for executing commands only without file transfer (e.g., Docker commands).
Deployment methodSelect the deployment method
Deployment orderSelect whether to deploy to multiple target servers in parallel or sequentially.
Deployment target VMSet the deployment target server.
  • Click the Settings button to open the Deployment Target VM Settings popup window.
Command before file deploymentEnter the command to be executed before file deployment.
File to transfer
  • Source: Enter the file path after the build pipeline execution path (Jenkins workspace).
  • Target: Enter the file path where the file will be deployed on the VM server.
  • Use the Add button to add files.
Command after file deploymentEnter the command to be executed after file deployment.
Auto-rollback settingSelect whether to enable auto-rollback.
  • If deployment fails, it will be rolled back to the previous successful deployment.
  • Enabled only when the deployment method is Agent.
Artifact repositorySelect whether to use an artifact repository for rollback.
  • Enabled only when the deployment method is Agent.
Repository nameOnly visible when using an artifact repository.
  • Displays a list of already registered artifact repositories.
Table. VM deployment addition input items
Note

The Deployment Target VM Settings popup window displays the server groups available for use.

For more information, see VM Server Group.

Viewing VM Deployment Details

To view the details of a VM deployment, follow these steps.

  1. Click the Project card on the Main page. Move to the Project Dashboard page.
  2. Click the Build/Deployment > VM Deployment menu on the left. Move to the VM Deployment page.
  3. Click the VM deployment you want to view in detail on the VM Deployment page. Move to the VM Deployment Details page.
  4. Click the server list on the History tab. The Deployment Details popup window opens.
  5. You can view detailed history in the Deployment Details popup window.
  6. Click the Log button of the execution pipeline to open the Pipeline Log popup window.
  7. You can view detailed logs in the Pipeline Log popup window.
  8. Click the Log button of the server you want to view logs for in the deployment server history list. The VM Agent Log popup window opens.
  9. You can view detailed logs in the VM Agent Log popup window.
ItemDescription
Pause/Start deploymentPause and Start Deployment buttons are enabled.
RollbackYou can roll back to a previous version.
History tabDisplays deployment history.
Pipeline Information tabDisplays the build pipeline information connected to the VM deployment.
LogYou can view the build pipeline log.
Table. VM deployment details screen items
ItemDescription
Execution pipeline logYou can view the build pipeline log.
Deployment server history logYou can view the deployment agent log.
  • Only visible for AGENT type
Table. Deployment details screen items

Deleting VM Deployment

Deleting from the List

To delete a VM deployment, follow these steps.

  1. Click the Project card on the Main page. Move to the Project Dashboard page.
  2. Click the Build/Deployment > VM Deployment menu on the left. Move to the VM Deployment page.
  3. Click the X icon of the VM deployment you want to delete on the VM Deployment page.
  4. Click the Confirm button in the confirmation popup window to complete the VM deployment deletion.

Deleting from the Details Page

To delete a VM deployment, follow these steps.

  1. Click the Project card on the Main page. Move to the Project Dashboard page.
  2. Click the Build/Deployment > VM Deployment menu on the left. Move to the VM Deployment page.
  3. Click the VM deployment you want to delete on the VM Deployment page. Move to the VM Deployment Details page.
  4. Click the Delete button on the VM Deployment Details page.
  5. Click the Confirm button in the confirmation popup window to complete the VM deployment deletion.

Using Environment Variables in VM Deployment Commands

You can use environment variables in file deployment commands before and after file deployment, source path of files to transfer, and target path of files to transfer.

You can use the $ symbol or the ${} symbol in the command to use the environment variables of the build pipeline.

Color mode
echo ${BUILD_NUMBER}
echo $JOB_NAME
echo ${BUILD_NUMBER}
echo $JOB_NAME
Environment variable usage example

If you want to refer to the environment variables of the VM server where the command is executed, add a \ symbol.

Color mode
echo \${PATH}
echo \$LANG
echo \${PATH}
echo \$LANG
VM server environment variable reference example

Pausing VM Deployment

You can pause an ongoing VM deployment on the Deployment Details page. Click the Pause button in the recent deployment status section of the Deployment Details page to pause the VM deployment.

The deployment pause is possible in the following states, and the Pause button is only displayed when in these states.

Method
Status value
Description
SSHRequestBuild pipeline is running
AGENTRequestBuild pipeline is running
Build completeBuild pipeline has completed
  • Must set the manual_deploy parameter to Use when running the build pipeline. If not used, it changes to the ready state immediately.
  • The Start Deployment button is enabled, and clicking it changes to the ready state.
  • Can be changed to the ready state using the VM deployment task in release management.
ReadyAGENT can perform deployment
In progressAGENT is executing deployment
Table. States where deployment pause is possible

Understanding VM Deployment Status Values

You can check the current status of a VM deployment on the Deployment Details page.

Method
Status value
Description
SSHNot executedInitially created and never executed
RequestBuild pipeline is running
SuccessBuild/deployment was successful
FailureBuild or deployment failed
AGENTNot executedInitially created and never executed
RequestBuild pipeline is running
Build completeBuild pipeline has completed
  • Must set the manual_deploy parameter to Use when running the build pipeline. If not used, it changes to the ready state immediately.
  • The Start Deployment button is enabled, and clicking it changes to the ready state.
  • Can be changed to the ready state using the VM deployment task in release management.
ReadyAGENT can perform deployment after build pipeline completion
In progressAGENT is executing deployment
SuccessBuild/deployment was successful
FailureBuild or deployment failed
PausedBuild or deployment was paused
  • Pause button is enabled and can be paused by clicking.
Table. Description of deployment status values
ArgoCD
Helm Install