Previews, production, and everything in between

Intuitive service discovery

Different environments use different hostnames and tools for service discovery, load balancing, and security. Don’t let that slow down development and let Architect configure it for you.

services:
  auth:
    build:
      context: ./auth-service
    interfaces:
      rest:
        port: 8080
    environment:
      LOG_LEVEL: info

  api:
    build:
      context: ./api-service
    interfaces:
      rest:
        port: 8081
    environment:
      # Populate peer addresses by reference. Architect will
      # automatically instrument service discovery and strict
      # network policies with each deployment
      AUTH_URL: ${{ services.auth.interfaces.rest.url }}

External dependency injection

Your app is distributed, and so is the knowledge of its architecture. Leverage familiar dependency management practices to connect to databases, message queues, peer APIs, and other external dependencies.

# Claim dependencies that will be automatically provisioned
# as-needed to power your own services
dependencies:
  postgres/postgres: 13
  company/auth: 1.2.0

services:
  api:
    build:
      context: ./api-service
    interfaces:
      rest:
        port: 8081
    environment:
      # Automatically connect to APIs exposed by dependencies w/out
      # getting lost in the details
      DB_URL: ${{ dependencies['company/auth'].interfaces.db.url }}
      AUTH_URL: ${{ dependencies['company/auth'].interfaces.app.url }}

Private developer environments

Running and testing features and services is critical for developer productivity. Architect’s automation isn’t just for production environments, but for private developer environments as well.

# Single command to stand up private dev environment
$ architect dev ./architect.yml

# ...streaming docker compose logs...
Wrote docker-compose file to: ~/.config/architect/docker-compose/architect.yml
[+] Building 0.9s (11/12)
 => [architect_cloud-api-worker-a8ucsqbe internal] load build definition from Dockerfile                                          0.0s
[+] Building 3.9s (12/21)
 => [architect_cloud-api-worker-a8ucsqbe internal] load build definition from Dockerfile                                          0.0s
 => => transferring dockerfile: 671B                                                                                              0.0s
 => [architect_cloud-app-1ywfwdkp internal] load build definition from Dockerfile                                                 0.0s
 => => transferring dockerfile: 1.04kB                                                                                            0.0s
 => [architect_auth-app-frykeeda internal] load build definition from Dockerfile                                                  0.0s
 => => transferring dockerfile: 210B                                                                                              0.0s
 => [architect_cloud-registry-proxy-phkgeuwd internal] load build definition from Dockerfile                                      0.0s
 => => transferring dockerfile: 481B                                                                                              0.0s
# ...

Preview environments

The earlier a feature can be tested in a production-like environment, the faster the changes can be trusted and released. Architect’s automation enables full environments to be provisioned and destroyed with each pull request.

# GitHub actions workflow template
name: Architect Create Preview

# Triggers on every pull request
on:
  pull_request:
    branches:
      - master

jobs:
  create_preview:
    runs-on: ubuntu-latest
    steps:
      # ...
      - run: sudo npm install -g @architect-io/cli
      - run: architect login -e me@domain.com -p mysecurepassword
      - run: architect register ./architect.yml -t preview-${{ github.event.number }}
      - run: architect environment:create preview-${{ github.event.number }} -a architect-account --platform preview-platform || exit 0
      - run: architect deploy --auto_approve -a architect-account -e preview-${{ github.event.number }} architect-account/my-component:preview-${{ github.event.number }}

Self-service deployments

Consistency is the key to successful deployments. Deploying with Architect is the same for every service and every environment, making production deployments safe and reliable for every developer on your team.