Skip to content

omnistrate-ctl Integration

Omnistrate CTL has a number of features that enable it to be seamlessly integrated with scripted and automated environments such as CI.

Using omnistrate-ctl with GitHub Actions

Create secrets in your repository for your Omnistrate email and password and use omnistrate-ctl from your Github workflows using Setup Omnistrate CTL Action.

- name: Setup Omnistrate CTL
  uses: omnistrate-oss/setup-omnistrate-ctl@v1
  with:
    email: ${{ secrets.OMNISTRATE_USERNAME }}
    password: ${{ secrets.OMNISTRATE_PASSWORD }}
    version: latest # OPTIONAL

# Execute and example command
- name: Test CTL command
  run: |
    # rum simple command as an example
    omnistrate-ctl --version
    # omctl alias is also supported
    omctl --version

Automating your CI/CD process with Omnistrate with GitHub Actions

Omnistrate allow you to Automate your CI/CD process and integrate with any CI/CD tool. Our community contributions provide a guideline on how to setup your build, test, release and fleet patching Actions on GitHub.

To get the example from the repo you can clone it using:

# Template availale at
gh repo clone omnistrate-community/ci-cd-example

Using omnistrate-ctl with Docker

omnistrate-ctl is packaged and released in a container image that can be used to execute the command:

docker run -t ghcr.io/omnistrate/ctl:latest

To log into the container and execute a series of commands, run the following command:

docker run -it --entrypoint /bin/sh -t ghcr.io/omnistrate/ctl:latest

To persist the credentials across multiple container runs, run the following command

docker run -it -v ~/omnistrate-ctl:/omnistrate/ -t ghcr.io/omnistrate/ctl:latest