Skip to content

Alis Build Environments

Alis Build Environments give people and agents a secure place to build together in your own Google Cloud: a build environment, listed under Environments in the console. A build environment owns products; a product has services and the deployment environments they deploy into. This page lists every Environments screen in the console at https://console.alisx.com, with its path, what it shows and what you can do there, and the commands that manage the same things from the CLI. Paths are relative to the console host; <org>, <product> and <env> are ids.

The names, fields and states behind these screens are in the resource model.

Build environments

Screen Path Contents Actions
Build environments /build/environments The build environments you can open. Request access when your account already has a build environment you cannot open; New build environment (leads to setup); search.
Build environment /build/environments/<org> The build environment's products with their activity, the Git remote of its definitions repo, and its shared infrastructure. Find a product; Sort by; New product (identifier, display name, region); refresh.
Build environment setup /build/init Where your account stands with a build environment. Start a new setup.
Set up a new build environment /build/init/extension Two ways: Fill in a form (Environment id, Display name, Region, Billing account id), or Work with the Init Agent, which sets up the Google Cloud organisation and billing account with you in a Chrome side panel. Create setup, run the command it shows in Google Cloud Shell, then Follow its progress.
Build environment initialisation /build/setups/<setupId> The progress of one setup, module by module, with any failure. Refresh; follow the link handed to whoever runs it.

Product

All product pages live under /build/environments/<org>/products/<product>/.

Screen Path Contents Actions
Overview overview Product overview: services across deployment environments, the product's project card (Project ID, Default region) and Shared infrastructure. Open a service or the build environment.
Story story Product story (Preview): the work, where it went, in detail. Regenerate story.
Usage usage API usage (Preview): the latest hourly usage snapshot per package and method, per deployment environment. Filter by deployment environment; search packages and methods; refresh.
Services services Services: every service with its version in each deployment environment. Search services; Add neuron (identifier); Add environment (display name, Production, Default region); select a deployment to pick a version and deploy it, or Destroy.
Variables variables Environment variables as a matrix across deployment environments. Edit; Save, Save and Deploy, Plan Deploy; Revert; search; filter deployment environments.
Routes routes Routes (Alpha): hostnames and backends per deployment environment. Add route; edit; delete. Administrators only.
Reference reference/overview, reference/packages/<packageId> API reference of the product's defined packages: services, methods, messages, enums, resources and events. Search the reference.
Sharing share Who has access and with which role. Grant, change or remove access. Administrators only.

Deployment environment

All deployment environment pages live under /build/environments/<org>/products/<product>/environments/<env>/.

Screen Path Contents Actions
Overview overview Deployed services (what runs here now), Deploy designation (type and designated branches), the project card. Delete environment.
Variables variables Environment variables with masked values. Add environment variable (name, value); Reveal value; Edit value; Store in Secret Manager / Store in Alis instead; Unset variable; Save and Deploy; Plan Deploy.
Monitoring monitoring Alert recipients. Add an Email address.

Code blocks

Screen Path Contents Actions
Code blocks /build/blocks Blocks by release level: Stable, Release Candidate, Beta, Alpha, Experimental. Search; Sort by; Create block (/build/blocks/new).
Block /build/blocks/<blockId>/overview The block's overview, plus Documentation, Versions, Instances, Share, Help and Settings pages. Install into a product; edit overview and documentation (owners); manage instances, versions and access (owners).

Glass views

A Glass view shows the live inside of one of your things. Open it with the Glass view button in that thing's title bar.

Glass view Path Shows
A build environment /build/environments/<org>/glass Its products, their services and its shared infrastructure.
A product /build/environments/<org>/products/<product>/glass Where each of the product's deployments stands against its deployment environment's designated branches.

How releases and Makefiles work is explained in How releases work and How Makefiles work.

From the CLI

Command Purpose
alis org Manage build environments
alis product Manage products
alis environment Manage deployment environments
alis service Manage services
alis clone Clone or refresh a product's define and build repos locally
alis context Where this folder sits: its build environment, product, service and deployment environments
alis authorise Refresh git and package credentials for a product
alis blocks Browse and manage a service's code blocks