Start with Impero

1. Create account and your first server. Connect new or existing server by executing:
   $ bash <(curl -s https://impero.foobar.si/install-key.sh)

2. Create new application and select project source GIT repository.

3. Configure your /.pckg/pckg.yaml file and commit it.

Minimum configuration

We want to deploy apache webserver with php (foo/web image) and mysql database server (foo/db). Example below would be sufficient enough for basic wordpress instalations.

repository: git@bitbucket.org:foo/bar.git
branch: master

system:

  web:
    image: foo/web

  database:
    image: foo/db

resources:

  database:
    system: database
    mysql:
      type: search
      name: foo_db
      foo_user:
        foo_db: basic

services:

  web:
    system: web
    apache:
      root: www
        

Basic commands

By adding additional commands you control what happens on each step: init (initialize project), prepare (import project defaults and populate database) and deploy (change database schema or execute migrations).

init:
   - command:install-dependencies

prepare:
   - php console migrator:install --repository=default --schema
   - php console migrator:install --repository=default --fields
   - php console user:create john@doe.com
   - command:clear-cache

deploy:
   - command:pull-git
   - php console migrator:install --repository=default

commands:

  install-dependencies:
    - yarn install --silent --production
    - composer install --no-dev --optimize-autoloader --ignore-platform-reqs --prefer-dist

  pull-git:
    - git reset --hard
    - git pull --ff
        

Deployment strategy

Additionally, there's a section called bring-up where you can tweak steps taken to deploy project.

bring-up:
  resource:database:
  service:web
  command:checkout:
    when:
      - service:web:filesystem:ready
  service:config:
    when:
      - resource:database:ready
      - command:checkout:end
  service:cron:
    when:
      - service:config:ready