2015-07-01 16:57:27 +02:00
|
|
|
# Building a Compose release
|
|
|
|
|
|
|
|
|
|
## Building binaries
|
|
|
|
|
|
2015-07-01 19:06:09 +02:00
|
|
|
`script/build-linux` builds the Linux binary inside a Docker container:
|
2015-07-01 16:57:27 +02:00
|
|
|
|
|
|
|
|
$ script/build-linux
|
|
|
|
|
|
2015-07-01 19:06:09 +02:00
|
|
|
`script/build-osx` builds the Mac OS X binary inside a virtualenv:
|
2015-07-01 16:57:27 +02:00
|
|
|
|
|
|
|
|
$ script/build-osx
|
|
|
|
|
|
|
|
|
|
For official releases, you should build inside a Mountain Lion VM for proper
|
|
|
|
|
compatibility. Run the this script first to prepare the environment before
|
|
|
|
|
building - it will use Homebrew to make sure Python is installed and
|
|
|
|
|
up-to-date.
|
|
|
|
|
|
|
|
|
|
$ script/prepare-osx
|
|
|
|
|
|
|
|
|
|
## Release process
|
|
|
|
|
|
|
|
|
|
1. Open pull request that:
|
|
|
|
|
- Updates the version in `compose/__init__.py`
|
|
|
|
|
- Updates the binary URL in `docs/install.md`
|
|
|
|
|
- Adds release notes to `CHANGES.md`
|
|
|
|
|
2. Create unpublished GitHub release with release notes
|
|
|
|
|
3. Build Linux version on any Docker host with `script/build-linux` and attach
|
|
|
|
|
to release
|
|
|
|
|
4. Build OS X version on Mountain Lion with `script/build-osx` and attach to
|
|
|
|
|
release as `docker-compose-Darwin-x86_64` and `docker-compose-Linux-x86_64`.
|
|
|
|
|
5. Publish GitHub release, creating tag
|
|
|
|
|
6. Update website with `script/deploy-docs`
|
|
|
|
|
7. Upload PyPi package
|
|
|
|
|
|
|
|
|
|
$ git checkout $VERSION
|
|
|
|
|
$ python setup.py sdist upload
|
