Installation

If you would like to try Workflows, please contact us to sign up for a free one-month trial of Aspect Enterprise!

Starting your trial

We're excited to get started, but first a note of caution.

These installation instructions are intended for teams starting their trial.

During the trial, don't introduce dependencies on Workflows. Don't make Workflows a blocking part of your developer's workflow, and don't ship artifacts it produces to production. We recommend you deploy into a separate AWS subaccount or GCP project, and take care during Terraform apply to leave your existing infrastructure alone.

Setting up Aspect Workflows happens in these steps:

1. Planning: Determine where the infrastructure will be deployed.
2. Setup Infrastructure: Deploy CI runners using our terraform module.
3. Hooks from CI: Configure the CI platform to trigger work using the Aspect runners.

Prerequisites

Minimum supported versions:

• Terraform >= 1.4
• AWS Provider >= 4.58.0 < 5.0.0 (for AWS)
• Google Provider >= 4.63.1 (for GCP)
• Kubernetes Provider >= 2.0.1
• Helm Provider >= 2.9.0

Planning

Which CI system will developers interact with?

Note that Workflows supports your Bazel workloads, but non-Bazel workloads such as legacy build systems, cron jobs, or deployment scripts will be configured separately.

Aspect Workflows supports these CI systems:

• Buildkite
• CircleCI
• GitHub Actions
• Gitlab

If you use a different CI system, we can probably add support for it. Get in touch with us!

Where do you plan to run the infrastructure?

Aspect Workflows supports these cloud providers:

• Amazon Web Services (AWS)
• Google Cloud Platform (GCP)

We prefer to deploy into your cloud ("on-prem"), so that you remain in control of your code.

Which account/project will the infrastructure deploy to?

We can co-manage the infrastructure with you, if you provide access.

By creating a separate AWS Account or GCP Project, you can reduce the access needed by Aspect engineers to co-manage the infrastructure. It also gives you a separate billing report for Workflows, making it easier to do the cost-benefit analysis to prove that Workflows is a net savings.

Who is the point-of-contact for install?

Aspect's engineers will work with someone in your org to perform the installation outlined below. We should only need 2-4 hours of this person's time. As with any engineering project, the closer we work together the faster this is completed.

Installing

On the left, choose your infrastructure provider and follow that installation guide. Then, choose your CI provider and follow that installation guide.