Documentation

Unity Gaming Services CLI

GitHub Repository

Unity Gaming Services CLI

Troubleshooting Deployment Definition

Solve common issues when running commands against a Deployment Definition.
Read time 1 minuteLast updated 21 hours ago

Possible Errors

There are a few errors that can occur when trying to use commands with a Deployment Definition.
  1. File intersection.
    1. With another file.
    2. With an excluded file.
  2. Multiple Deployment Definitions in the same directory.

File intersection

Using a Deployment Definition is a separate logical grouping than files or directories.

With Another File

If the set of files a Deployment Definition is responsible for intersects with other items in the command, the following error will occur: Command: 
ugs deploy Assets/DeployableAssets/CloudCode/CloudCode.ddef Assets/DeployableAssets/CloudCode/scriptA.js
 
Assets/├── DeployableAssets/│   ├── CloudCode/│   │   ├── CloudCode.ddef│   │   ├── scriptA.js│   │   ├── scriptB.js│   │   └── Tests/│   │       ├── scriptA_test.js│   │       └── scriptB_test.js
[Error]:A conflict was found between the deployment definitions and the other arguments:    'Assets/DeployableAssets/CloudCode/scriptA.js' [CloudCode.ddef]

With an Excluded File

If the set of excluded files for a Deployment Definition intersects with other items in the command, the following error will occur: Command: 
ugs deploy Assets/DeployableAssets/CloudCode/CloudCode.ddef Assets/DeployableAssets/CloudCode/scriptA.js
 
Assets/├── DeployableAssets/│   ├── CloudCode/│   │   ├── CloudCode.ddef│   │   ├── scriptA.js│   │   ├── scriptB.js│   │   └── Tests/│   │       ├── scriptA_test.js│   │       └── scriptB_test.js
[Error]:A conflict was found between the deployment definition exclusions and the other arguments:    'Assets/DeployableAssets/CloudCode/Tests/scriptA_test.js' [CloudCode.ddef]

Multiple Deployment Definitions in a Directory

Given that a Deployment Definition is responsible for a whole directory, having multiple Deployment Definition in the same directory will cause an error when trying to execute a command that involves them. Command: 
ugs deploy Assets/DeployableAssets/CloudCode/CloudCode.ddef Assets/DeployableAssets/CloudCode/scriptA.js
 
Assets/├── DeployableAssets/│   ├── CloudCode/│   │   ├── CloudCode1.ddef│   │   ├── CloudCode2.ddef│   │   ├── scriptA.js│   │   ├── scriptB.js│   │   └── Tests/│   │       ├── scriptA_test.js│   │       └── scriptB_test.js
[Error]:Multiple deployment definitions were found in the directory 'Assets/DeployableAssets/CloudCode': 'CloudCode1.ddef' and 'CloudCode2.ddef'

Fetch with --reconcile

As mentioned in the commands page, it is not possible to use the 
--reconcile
with the fetch command when using Deployment Definition. Attempting to do so will generate the following error message: 
[Error]:Reconcile is not compatible with Deployment Definitions