Skip to main content

CI/CD overview

DataStar slots into build and release pipelines through two components and several pipeline-specific integrations.

The CLI tools

Two cross-platform .NET command-line utilities cover everything a build agent needs to do:

  • DataStar.Tools. Runs deployments. Takes a deployment manifest and executes it against a target database. Supports Oracle and SQL Server, audit tables, reversal-script generation, and NuGet-package publishing.
  • GitSources.Tools. Packages the scripts referenced by a deployment file out of a Git checkout and produces a deployable artefact (NuGet or zip) ready for Octopus or any other release tool.

Both run anywhere .NET does.

Pipeline integrations

Azure DevOps

First-class task library published to the Visual Studio Marketplace.

Octopus Deploy

Bitbucket Pipelines

  • Bitbucket Pipelines. A worked example using the DataStar tools from Bitbucket with Jira for deployment-file storage.

A general shape

Whatever the pipeline, most DataStar CI/CD flows share the same four stages:

  • Stage 1 pulls the deployment file (from source control, from a Jira / Azure Boards attachment, or from a shared release folder).
  • Stage 2 gathers the SQL scripts referenced by the manifest, the DataStar.Tools CLI, and the component templates (needed if reversal is enabled). Produces a single artefact.
  • Stage 3 pushes the artefact to whatever feed your release tool watches.
  • Stage 4 runs the DataStar.Tools CLI against the target environment to execute the deployment.

The integration pages above show how each specific CI/CD system realises this shape.