# Sync

> Synchronize a local directory with a cloud content delivery bucket by creating, updating, and deleting entries to match the local files.

Synchronize a local directory with a cloud content delivery bucket.
Automatically creates, updates, and deletes entries
within the bucket to match the files in the local directory.

## Command

```text
ugs ccd entries sync <local-directory-path> [options]
```

## Arguments

* `<local-directory-path>`: The local directory path to synchronize.

## Options

| Option                            | Alias                                   | Description                                                                                                                               |
| --------------------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| bucket-name                       | -b, --bucket-name                       | The ID of the target bucket.                                                                                                              |
| exclude                           | -f, --exclude                           | Exclude files and folders matching this pattern.                                                                                          |
| dry-run                           | -d, --dry-run                           | Prints the operations that would be performed without actually executing them.                                                            |
| retry                             | -z, --retry                             | Number of times to retry syncing a file (default is 3).                                                                                   |
| timeout                           | -t, --timeout                           | Upload timeout in seconds (default is no timeout).                                                                                        |
| delete                            | -x, --delete                            | Entries that do not exist locally are deleted during sync.                                                                                |
| badge                             | -u, --badge                             | Badge to be assigned to the new release if create release flag is set.                                                                    |
| label                             | -l, --label                             | The label to associate with the entries.                                                                                                  |
| create-release                    | -r, --create-release                    | Creates a release containing the files that were synced.                                                                                  |
| include-entries-added-during-sync | -i, --include-entries-added-during-sync | Including entries added to the bucket during the ongoing synchronization process to ensure all new additions are captured in the release. |
| metadata                          | -m, --metadata                          | JSON metadata to associate with the release and entries.                                                                                  |
| notes                             | -n, --release-notes                     | The notes associated with the release.                                                                                                    |
| help                              | -?, -h, --help                          | Display help and usage information.                                                                                                       |
| quiet                             | -q, --quiet                             | Reduce logging to a minimum.                                                                                                              |
| json                              | -j, --json                              | Use JSON as the output format.                                                                                                            |