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
(Agent method) VM deployment
Starting VM Deployment
To start a VM deployment, follow these steps.
- Click the Project card on the Main page. Move to the Project Dashboard page.
- Click the Build/Deployment > VM Deployment menu on the left. Move to the VM Deployment page.
| Item | Description |
|---|---|
| Deployment group name | Displays 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.
|
| Deployment time | Displays the deployment time. |
| Delete | Deletes the VM deployment. |
Adding VM Deployment
To add a VM deployment, follow these steps.
- Click the Project card on the Main page. Move to the Project Dashboard page.
- Click the Build/Deployment > VM Deployment menu on the left. Move to the VM Deployment page.
- Click the Add VM Deployment button at the top right of the VM Deployment page. The Add VM Deployment popup window opens.
- Enter information in the Add VM Deployment popup window and click the Save button.
| Item | Description |
|---|---|
| Deployment group | Enter the deployment group name. |
| Execution method | Select the execution method.
|
| Deployment method | Select the deployment method |
| Deployment order | Select whether to deploy to multiple target servers in parallel or sequentially. |
| Deployment target VM | Set the deployment target server.
|
| Command before file deployment | Enter the command to be executed before file deployment. |
| File to transfer |
|
| Command after file deployment | Enter the command to be executed after file deployment. |
| Auto-rollback setting | Select whether to enable auto-rollback.
|
| Artifact repository | Select whether to use an artifact repository for rollback.
|
| Repository name | Only visible when using an artifact repository.
|
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.
- Click the Project card on the Main page. Move to the Project Dashboard page.
- Click the Build/Deployment > VM Deployment menu on the left. Move to the VM Deployment page.
- Click the VM deployment you want to view in detail on the VM Deployment page. Move to the VM Deployment Details page.
- Click the server list on the History tab. The Deployment Details popup window opens.
- You can view detailed history in the Deployment Details popup window.
- Click the Log button of the execution pipeline to open the Pipeline Log popup window.
- You can view detailed logs in the Pipeline Log popup window.
- 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.
- You can view detailed logs in the VM Agent Log popup window.
| Item | Description |
|---|---|
| Pause/Start deployment | Pause and Start Deployment buttons are enabled. |
| Rollback | You can roll back to a previous version. |
| History tab | Displays deployment history. |
| Pipeline Information tab | Displays the build pipeline information connected to the VM deployment. |
| Log | You can view the build pipeline log. |
| Item | Description |
|---|---|
| Execution pipeline log | You can view the build pipeline log. |
| Deployment server history log | You can view the deployment agent log.
|
Deleting VM Deployment
Deleting from the List
To delete a VM deployment, follow these steps.
- Click the Project card on the Main page. Move to the Project Dashboard page.
- Click the Build/Deployment > VM Deployment menu on the left. Move to the VM Deployment page.
- Click the X icon of the VM deployment you want to delete on the VM Deployment page.
- 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.
- Click the Project card on the Main page. Move to the Project Dashboard page.
- Click the Build/Deployment > VM Deployment menu on the left. Move to the VM Deployment page.
- Click the VM deployment you want to delete on the VM Deployment page. Move to the VM Deployment Details page.
- Click the Delete button on the VM Deployment Details page.
- 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.
echo ${BUILD_NUMBER}
echo $JOB_NAMEecho ${BUILD_NUMBER}
echo $JOB_NAMEIf you want to refer to the environment variables of the VM server where the command is executed, add a \ symbol.
echo \${PATH}
echo \$LANGecho \${PATH}
echo \$LANGPausing 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 |
|---|---|---|
| SSH | Request | Build pipeline is running |
| AGENT | Request | Build pipeline is running |
| Build complete | Build pipeline has completed
| |
| Ready | AGENT can perform deployment | |
| In progress | AGENT is executing deployment |
Understanding VM Deployment Status Values
You can check the current status of a VM deployment on the Deployment Details page.
| Method | Status value | Description |
|---|---|---|
| SSH | Not executed | Initially created and never executed |
| Request | Build pipeline is running | |
| Success | Build/deployment was successful | |
| Failure | Build or deployment failed | |
| AGENT | Not executed | Initially created and never executed |
| Request | Build pipeline is running | |
| Build complete | Build pipeline has completed
| |
| Ready | AGENT can perform deployment after build pipeline completion | |
| In progress | AGENT is executing deployment | |
| Success | Build/deployment was successful | |
| Failure | Build or deployment failed | |
| Paused | Build or deployment was paused
|