This document serves to describe breaking changes and provide upgrade hints when major changes are introduced. When you're creating a pull with some major changes, please add brief upgrade instructions here.
start_dependencies.sh
starts a local docker container with PostgreSQL 12.1 on port 20002.- There is no longer a distiction between dev and test database servers.
- Docker volumes by default point to
~/.aircloak/docker_volumes
.
To apply the change locally:
DB_ENV="dev" central/db/container.sh stop
DB_ENV="test" central/db/container.sh stop
mv /docker_volumes/central_db_dev /tmp/ && mv /docker_volumes/central_db_test /tmp/
central/db/build-image.sh
./start-dependencies.sh
cd central && make recreate-db
Notice that this will regenerate your central database from scratch, and you'll lose all the data you previously had.
- OS X users: manually install Erlang (see here for instructions)
- Run
asdf install
in the project root folder to install new dependencies.
- see here for migration instructions
Development and test databases are now running in the separate containers. After fetching the latest master, you need to stop the old container (docker stop air_db
), and then you can run air/start_dependencies.sh
which will start both database containers.
OS X developers: you also need to forward port 20003 from docker-machine
VM.
- Air web project now resides directly in the
air
folder. - Air listens on ports 8080 and 8443.
- Change in deploy syntax: use
air/production.sh target deploy
orcloak/production.sh target deploy
, wheretarget
is your first name (without paths). - New command to deploy air and cloak together:
./publish.sh target
. - Air is deployed to srv-76-135.
- Following components are not used anymore:
nginx
,haproxy
,etcd
,coreos
.
The change was made to get Travis to pick up our caches, and secondly it's what most people and projects expect. Update your local git remotes.
- Cloak project is now compiled with
mix
and powered by Elixir. You'll need Erlang 18.x and Elixir >= 1.2.3 to run it. There is theMakefile
file in thecloak
folder with typical tasks. - Extended proper tests (full, batch) are currently not working, and they are excluded from Travis tests.
- The role which accesses the test database has been changed, so your local tests will probably break. To fix this, start the docker database container, drop
air_test
database, and finally restart the database container.
- New pseudo local site has been introduced:
insights.air-local
. You need to add the corresponding entry to your/etc/hosts
. - The certificate in
air/router/dev_cert/aircloak.com.chain.pem
has been changed. You need to delete the old key from your keychain, and import the new version as explained here. - The new site is now accessed through the router. You need to start air dependencies, and then the site will be available at https://insights.air-local:20000