--- title: "Alis Build Environments" url: "https://docs.alisx.com/reference/environments/" --- # 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 , 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; ``, `` and `` are ids. The names, fields and states behind these screens are in the [resource model](https://docs.alisx.com/reference/environments/resource-model.md). ## 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/` | 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/` | 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//products//`. | 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/` | **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//products//environments//`. | 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//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//glass` | Its products, their services and its shared infrastructure. | | A product | `/build/environments//products//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](https://docs.alisx.com/explanation/releases.md) and [How Makefiles work](https://docs.alisx.com/explanation/makefiles.md). ## From the CLI | Command | Purpose | |---|---| | [`alis org`](https://docs.alisx.com/reference/cli/org.md) | Manage build environments | | [`alis product`](https://docs.alisx.com/reference/cli/product.md) | Manage products | | [`alis environment`](https://docs.alisx.com/reference/cli/environment.md) | Manage deployment environments | | [`alis service`](https://docs.alisx.com/reference/cli/service.md) | Manage services | | [`alis clone`](https://docs.alisx.com/reference/cli/clone.md) | Clone or refresh a product's define and build repos locally | | [`alis context`](https://docs.alisx.com/reference/cli/context.md) | Where this folder sits: its build environment, product, service and deployment environments | | [`alis authorise`](https://docs.alisx.com/reference/cli/authorise.md) | Refresh git and package credentials for a product | | [`alis blocks`](https://docs.alisx.com/reference/cli/blocks.md) | Browse and manage a service's code blocks | ## Related - [Resource model](https://docs.alisx.com/reference/environments/resource-model.md) - [Alis Build DBD](https://docs.alisx.com/reference/dbd/index.md), for defining, building and deploying a service - [Organisations, products and services](https://docs.alisx.com/explanation/organisations-products-services.md) - [How releases work](https://docs.alisx.com/explanation/releases.md) - [How Makefiles work](https://docs.alisx.com/explanation/makefiles.md) - [How code blocks work](https://docs.alisx.com/explanation/code-blocks.md)