Steps
Documents all the different types of steps that can be used within workflows
Last updated
Documents all the different types of steps that can be used within workflows
Last updated
The import package step will import an artifact from an external source into the Chassy Index. The following external sources are supported:
Docker Registry
GitHub Actions Workflow
GitHub Actions Package
Artifactory
AWS S3 Bucket
Wasabi Bucket
The GitHub Actions Package mentioned here is not to be confused with packages uploaded using our Package Upload Action. Packages uploaded via the Package Upload Action can already be found within the Chassy Index.
In Chassy’s context, artifacts are any inputs, outputs or deliverables produced during the development and delivery process. These artifacts can include applications binaries, compressed archives, container images or file systems. Artifacts play a crucial role in DevOps pipelines, as they enable the automation and traceability of the software delivery process.
Type - to bring an artifact into the Chassy Index, create a new step, and select "Import Package" under type.
Name - Under the name field, create a name that accurately describes your Workflow Step. This is what will be used to uniquely identify this step in your Chassy Workflow.
Timeout - Under the Timeout field, select an appropriate duration before giving up on the task. This will prevent the workflow from running indefinitely if there is an issue. A good rule of thumb is to set the timeout to be slightly longer than the expected runtime of the task.
Artifact Name - The Artifact Name field specifies the name of the artifact to be imported. This is the name used by the external source. For example, an artifact retrieved from an S3 bucket will be the S3 file path.
Source - The source from which the artifact is to be pulled
Type - The type of package (image, file, archive, etc)
Versioning - These options denote the versioning schema. By default, you can auto-increment the major release, the minor release, or the patch. If you wish to do something more custom, a regex field is present.
Auto Increment Major Release: This option will automatically increment the major release number of the artifact each time a new version is created.
Auto Increment Minor Release: This option will automatically increment the minor release number of the artifact each time a new version is created.
Auto Increment Patch Release: This option will automatically increment the patch release number of the artifact each time a new version is created.
Version Regex: This option allows you to specify a custom regular expression to use for versioning. The regular expression must match the version number of the artifact.
There are other configurations that relevant to your chosen source. For example, if you choose to import from AWS S3, you will need to provide a bucket name and file name.
The find package step will bring a package from the Chassy Index into the context of a workflow's execution. If you want to deploy a binary to a fleet, this binary will need to be found with find package before it can be deployed.
Type - To bring in an artifact, create a new workflow and select “Find and Import” under Type.
Name - Under the name field, create a name that accurately describes your Workflow Step. This is what will be used to uniquely identify this step in your Chassy Workflow.
Timeout - Under the Timeout field, select an appropriate duration before giving up on the task. This will prevent the workflow from running indefinitely if there is an issue. A good rule of thumb is to set the timeout to be slightly longer than the expected runtime of the task.
Package Name - The package name is a unique identifier for an artifact within a workspace. It is used to reference the artifact in workflows and other contexts. When creating an artifact, you must specify a package name. The package name must be unique within the workspace and should accurately reflect the contents of the artifact. It is recommended to use a naming convention that is consistent with your organization's standards.
For example, if you are creating an artifact that contains the binaries for a web application, you might use the package name "web-app-binaries".
Chassy will take care of versioning so this should just be the “base name”. We follow the guidelines set in Semantic Versioning
Version - version of the package (packages are optionally versioned).
Package Id - Id of your preferred package (optional)
Selection order - the order in which collisions are handled when multiple packages are found with the provided configurations
Type - To bring in an artifact, create a new workflow and select “Find and Import” under Type.
Name - Under the name field, create a name that accurately describes your Workflow Step. This is what will be used to uniquely identify this step in your Chassy Workflow.
Timeout - Under the Timeout field, select an appropriate duration before giving up on the task. This will prevent the workflow from running indefinitely if there is an issue. A good rule of thumb is to set the timeout to be slightly longer than the expected runtime of the task.
Depends On - In Chassy, the "Depends On" field allows you to specify other tasks that must complete before the current task can execute. This is useful for ensuring that tasks are executed in the correct order and that dependencies are met.
To specify a dependency, simply enter the name of the task in the "Depends On" field. You can specify multiple dependencies by separating them with commas.
The "Depends On" field is a powerful tool that can help you ensure that your workflows are executed correctly and efficiently.
Fleet - Select and list from the dropdown menu the fleet to target.
Release - Select the release to target. Please refer to Release above for more information.
Type - Currently supported types are Testbed and Production, more types coming soon.
Count - Select the number of Machines in the fleet to release to. “All” can be selected to deploy to the whole fleet.
Attributes
OS Name - the OS the package is to be deployed to
OS Version - the OS version the package is to be deployed to.
IP Address - the target machine’s iP address. Only one of hostname or IP address is required.
Host Name - the Machines hostname. Only one of hostname or ip address is required.
Properties
Key Value - enter an unique key value pair
Type - To bring in an artifact, create a new workflow and select “Find and Import” under Type.
Name - Under the name field, create a name that accurately describes your Workflow Step. This is what will be used to uniquely identify this step in your Chassy Workflow.
Timeout - Under the Timeout field, select an appropriate duration before giving up on the task. This will prevent the workflow from running indefinitely if there is an issue. A good rule of thumb is to set the timeout to be slightly longer than the expected runtime of the task.
Depends On - In Chassy, the "Depends On" field allows you to specify other tasks that must complete before the current task can execute. This is useful for ensuring that tasks are executed in the correct order and that dependencies are met.
When creating a release package, all the deploy packages that it depends on are automatically included in the release package. This simplifies the release process and ensures that all necessary components are included in the deployment.
To specify a dependency, simply enter the name of the task in the "Depends On" field. You can specify multiple dependencies by separating them with commas.
Release Name -The Artifact Name field specifies the name of the artifact to be deployed. This is the unique name within the workspace and Chassy will identify and retrieve the package.
Target Chip - This drop down lists all available chips for you to select the one that the release will target.
Manifest - The manifest is a file that is present in every release and contains information on what the release contains. Each file in the release should contain it’s own manifest entry. The configurable fields include the following:
Package Name - The name of the release package.
Package Version - Select whether to append two default tags (Latest and Current) or Manually input a custom string.
Add another Package - Option to add another Manifest entry for another package.
The step pauses the workflow for a specified duration before proceeding to the next step.
Name - Under the name field, create a name that accurately describes your Workflow Step. This is what will be used to uniquely identify this step in your Chassy Workflow.
Timeout - Under the Timeout field, select an appropriate duration before giving up on the task. This will prevent the workflow from running indefinitely if there is an issue. A good rule of thumb is to set the timeout to be slightly longer than the expected runtime of the task.
For Wait, ensure that the timeout is longer than the wait duration.
Depends On - In Chassy, the "Depends On" field allows you to specify other tasks that must complete before the current task can execute. This is useful for ensuring that tasks are executed in the correct order and that dependencies are met.
To specify a dependency, simply enter the name of the task in the "Depends On" field. You can specify multiple dependencies by separating them with commas.
Duration - The duration to wait, in milliseconds.
