Creating Jobs

Overview

A Job is a scheduled operation that is used to perform a backup and comparison of your Project(s) to the current instance in the Copia Server. Copia provides two options for creating jobs and scheduling backups:

• Sitewide Backup Schedule (Site Jobs) A sitewide Job backs up all the projects in a site. At the scheduled start time, a job run for each project will be queued and run in order. This ensures all projects are backed up, without having to configure a job for each project manually.

  • To configure a Sitewide Backup Schedule see the Site Settings section of the documentation: Sitewide Backup Schedule

• Project Backup Schedule (Standard Jobs) These Jobs have a 1-1 relationships with a Project. These give you more control over each specific Job setting (such as timeouts, auto-commit settings and more), but may take longer to configure for each project.

  • Continue reading below to setup Jobs for your projects

Contact Copia about automated options to create and configure your Jobs!

Creating a Job for a Project

To create a Job, navigate to the Jobs tab and press the Add a Job button.

General Settings

You should see a modal that allows you to configure your Job settings. Use the Project Name drop-down to select a Project to backup. The name of the chosen Project will be used to automatically populate the Job Name field (which can be modified if desired). The Timeout Duration refers to the amount of time given to a queued Job. You can modify it if more or less time is needed.

Scheduling

Scheduling allows you to set how often your Job should run. To turn on the scheduling feature, click the Schedule Job toggle.

The Daily option preselects weekdays. You can include weekends by enabling the Include Weekends checkbox. Use the Time selector to set the desired start time for the Job.

The Specific day(s) each week option allows you to choose which days of the week you prefer to perform a Project backup. __ Select which days of the week to run the Job and the set the time the Jobs should run with the Time selector.

If you prefer a more complex schedule, Copia provides the option to enter a "cron" schedule. Cron is a very simple but powerful scheduling format that is commonly used by system administrators. In this case, we provide a link to the crontab.guru site for syntax and examples to help you get started. Once you enter a correct cron schedule, a "plain text" interpretation will be displayed above the expression so you can validate your syntax.

Auto-Commit

Auto-Commit is a feature that allows you to backup, monitor, and be notified if your Devices change without any additional manual involvement. Auto-Commit will create a new branch to store this data so that it does not interfere with development. In this way, Auto-Commit provides easy disaster recovery and access to all machine updates.

When auto-commit is enabled, the device will be compared to the latest commit in the DeviceLink branch. If a difference is detected, a new commit will automatically be created, using the latest backup from the device. In this way the DeviceLink branch should always reflect the current state of the device.

The Auto-Commit feature is automatically enabled for new Jobs. By default, Auto-Commit is set to create a new branch with the DeviceLink/ProjectName syntax. If development on the Device is rare, or if you wish to use your own branch name, you can enter a new branch name into the New Branch Name field.

If a user chooses to disable Auto-Commit, they will need to manually create a Pull Request to update the branch that the project is stored on.