Build & Publish your Workflow
- Updated On 11 Feb 2021
- 2 Minutes To Read
-
DarkLight
Build and Publish Workflows
This document will describe how to build and publish your Commands, Services, or Pipelines. Building a CTO.ai workflow requires our Command Line Interface(CLI).
The CTO.ai CLI runs in either MacOS or GNU/Linux terminal. Windows support is currently in beta. The CLI provides comprehensive features that will let you develop, run, debug, and publish your workflows.
1. Install CTO.ai CLI
Click here for instructions
2. Sign In
You can sign in to your CTO.ai account with:
ops account:signin
Once you are signed in, you can now run your workflows with the ops run
command followed by the name of the workflow you want to run.
3. Create a Workflow
The quickest way to get started on a new workflow (Command, Service, or Pipeline) is to use our ops init
scaffold to set up a base project. Below is an example process for creating a Command, that also works for creating Pipelines and Services.
ops init
ops init
will present a few configuration options and then generate a scaffold workflow for you. Check out our Quick Start Guides to init
with your favorite framework.
Here's a NodeJS example scaffold:
$ ops init # generate new Op called 'example1'
$ ls -1a
.
..
.dockerignore
.npmignore
Dockerfile
index.js # your source code would go here
ops.yml
package.json
The code of the workflow goes in the index.js
file.
Check out the ops.yml and docker config and review our SDK for more information.
4. Build
The example above is a NodeJS workflow with an index.js
file that holds the source code for the Command. When you make changes to either the code or configuration files, you need to rebuild your workflow.
The build
step is where the different pieces of the workflow are packaged into one portable, shareable, containerized workflow.
From the folder of your workflow, build it with the ops build .
command. The .
indicates that you want to build the workflow that is in the current folder:
ops build .
This package still only exists on your computer.
5. Run/Test your workflow before you publish
Now that your workflow is built, you can run/test it (which still only exists locally) using the ops run
command:
ops run .
Again, the .
denotes the current folder— ops run
will run the workflow in the current folder, which in this case is example1
.
6. Publish
Once your workflow has been packaged using the ops build
command, you can publish it to your current team with the ops publish
command. When you publish, you’ll be able run the workflow remotely. You can publish multiple versions of your workflow to different teams.
ops publish <path/opName>
As part of the publishing process, you’ll be asked for a short changelog description of what is in the new version.
Your workflow will be published to your Team and can be found using ops list
.
7. Add Teammates
When you add a team member to your CTO.ai team they can run all of your team's workflows.
For more infomation on working with Teams, check out the Teams Page.
🚀 What's next?
- Create a Service, Command, or Pipeline to build and publish
- Learn more about Secrets and Config
- Learn about our SDK
📞 Need help? No problem!
- 📧 If you have questions, we are happy to help, please contact support
- 👉 Join our Slack Community to get help or share your ideas.