Zerops startCommands example

Zerops containers are based on Incus containers, placing them at a midpoint between containerized processes (e.g., Docker) and full-fledged VMs (e.g., Proxmox). This architecture allows Zerops to easily run multiple processes within a single container.

This example shows how to run Node.js application that uses SQLite along with Litestream, to persist the database throughout deployments.

zerops.yml

zerops:
  - setup: api
    build:
      base: nodejs@20
      prepareCommands:
        - npm install -g typescript
      buildCommands:
        - npm i
        - npm run build
      deployFiles:
        - ./dist
        - ./node_modules
        - ./package.json
        - ./litestream.yml
    run:
      base: nodejs@20
      prepareCommands:
        - wget https://github.com/benbjohnson/litestream/releases/download/v0.3.13/litestream-v0.3.13-linux-amd64.tar.gz
        - tar -xzf litestream-v0.3.13-linux-amd64.tar.gz
        - rm litestream-v0.3.13-linux-amd64.tar.gz
        - sudo mv litestream /usr/local/bin/
      ports:
        - port: 3000
          httpSupport: true
      envVariables:
        NODE_ENV: production
        DB_NAME: database.db
        STORAGE_API_URL: $storage_apiUrl
        STORAGE_ACCESS_KEY_ID: $storage_accessKeyId
        STORAGE_SECRET_ACCESS_KEY: $storage_secretAccessKey
        STORAGE_BUCKET_NAME: $storage_bucketName
      startCommands:
        - command: npm run start:prod
          name: server
        - command: litestream replicate -config=litestream.yml
          name: replication
          initCommands:
            - litestream restore -if-replica-exists -if-db-not-exists -config=litestream.yml $DB_NAME
      healthCheck:
        httpGet:
          port: 3000
          path: /status

litestream.yml

Litestream configuration file. Litestream automatically replaces environment varibles, so we make use of the env variables Zerops automatically generates for our object storage service.

access-key-id: $STORAGE_ACCESS_KEY_ID
secret-access-key: $STORAGE_SECRET_ACCESS_KEY

dbs:
  - path: $DB_NAME
    replicas:
      - type: s3
        path: $DB_NAME
        bucket: $STORAGE_BUCKET_NAME
        endpoint: $STORAGE_API_URL
        force-path-style: true

Test it yourself

Import this project to your Zerops account.

project:
  name: start-commands-example

services:
  - hostname: storage
    type: object-storage
    objectStorageSize: 2

  - hostname: api
    type: nodejs@20
    buildFromGit: https://github.com/zeropsio/start-commands-example
    enableSubdomainAccess: true

Filter logs in Zerops GUI