1
0
mirror of https://github.com/lineageos4microg/docker-lineage-cicd synced 2024-09-20 12:22:40 +02:00
docker-lineage-cicd/README.md
2017-01-08 17:50:24 +01:00

56 lines
2.0 KiB
Markdown

# docker-lineage-cicd
Docker microservice for LineageOS Continuous Integration and Continous Deployment
## Why
Because I always believe that even advanced technologies should be available to everyone. This is a tentative to offer everyone the possibility to build his own images of LineageOS, when he wants, how he wants. You don't have to wait anymore for build bots. No more scene drama. Just build and enjoy your favourite Android ROM.
## Why Docker?
Because I'm a big fan of isolating everything if possible. I don't want to reinstall my OS or triage with dirty packages, just because today I need somethng, and tomorrow I'll need something else.
## Requirements
- At least Dual Core CPU ( Higher is better )
- At least 6GB RAM ( Higher is better )
- At least 200GB HDD Space ( Higher is better )
## How it works
This docker will autobuild any device list given for a specified branch every midnight at 02:00 UTC. In the end, any built ZIP will be moved to the relative volume mapped directory to `/srv/out`.
> **IMPORTANT:** Remember to use VOLUME mapping. By default Docker creates container with max 10GB of Space. If you will not map volumes, the docker will just break during Source syncronization!
## Configuration
You can configure the Docker by passing custom environment variables to it. See the [Dockerfile](Dockerfile#L11) for more details.
## How to use
### Simple mode
build LineageOS for `hammerhead` with default settings
```
docker run \
--restart=always \
-d \
-e "DEVICE_LIST=hammerhead" \
-v "/home/user/ccache:/srv/ccache" \
-v "/home/user/source:/srv/src" \
-v "/home/user/zips:/srv/out" \
julianxhokaxhiu/docker-lineage-cicd
```
### Advanced mode
build cm-13.0 LineageOS for `hammerhead` and `bullhead`
```
docker run \
--restart=always \
-d \
-e "BRANCH_NAME=cm-13.0" \
-e "DEVICE_LIST=hammerhead,bullhead" \
-v "/home/user/ccache:/srv/ccache" \
-v "/home/user/source:/srv/src" \
-v "/home/user/zips:/srv/out" \
julianxhokaxhiu/docker-lineage-cicd
```