https://github.com/bertrandmartel/docker-jenkins-android
:whale: A jenkins docker image for Android development
https://github.com/bertrandmartel/docker-jenkins-android
android android-ndk android-sdk docker gitlab jenkins-docker-image
Last synced: about 2 months ago
JSON representation
:whale: A jenkins docker image for Android development
- Host: GitHub
- URL: https://github.com/bertrandmartel/docker-jenkins-android
- Owner: bertrandmartel
- License: mit
- Created: 2016-09-17T19:03:30.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2018-02-11T23:43:50.000Z (over 7 years ago)
- Last Synced: 2025-04-19T20:17:42.789Z (2 months ago)
- Topics: android, android-ndk, android-sdk, docker, gitlab, jenkins-docker-image
- Language: Shell
- Homepage: https://hub.docker.com/r/bertrandmartel/docker-jenkins-android
- Size: 3.33 MB
- Stars: 30
- Watchers: 3
- Forks: 15
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Jenkins Docker image for Android dev
[](https://travis-ci.org/bertrandmartel/docker-jenkins-android) [](https://microbadger.com/images/bertrandmartel/docker-jenkins-android) [](https://microbadger.com/images/bertrandmartel/docker-jenkins-android)
A jenkins docker image with Android SDK/NDK global install and the following pre-installed plugins :
* [gitlab-plugin](https://wiki.jenkins-ci.org/display/JENKINS/GitLab+Plugin) : build trigger on push
* [gitlab-logo](https://wiki.jenkins-ci.org/display/JENKINS/GitLab+Logo+Plugin) : gitlab repo icon on dashboard
* [gitlab-oauth](https://wiki.jenkins-ci.org/display/JENKINS/GitLab+OAuth+Plugin) : gitlab authentication
* [android-emulator](https://wiki.jenkins-ci.org/display/JENKINS/Android+Emulator+Plugin) : use android emulator in CI
* [ws-cleanup](https://wiki.jenkins-ci.org/display/JENKINS/Workspace+Cleanup+Plugin) : clean workspace before build
* [slack](https://wiki.jenkins-ci.org/display/JENKINS/Slack+Plugin) : send slack notifications
* [Embeddable Build Status Plugin](https://wiki.jenkins-ci.org/display/JENKINS/Embeddable+Build+Status+Plugin) : build status badge
Other packages are also downloaded to build Android applications correctly
## Run
```
docker run -p 8080:8080 -p 50000:50000 \
-v /home/user/Android/sdk:/opt/android/sdk \
-v /home/user/Android/ndk:/opt/android/ndk \
-v your_home/jenkins_home:/var/jenkins_home bertrandmartel/docker-jenkins-android
```
## Environment variables
| Variable name | description | sample value |
|----------------------------------|---------------------------------|------------------------------------------------------------------------|
| ANDROID_SDK | Android SDK release name | r25.2.2 |
| ANDROID_NDK | Android NDK release name | android-ndk-r12b |
| ERASE_ANDROID_SDK | clear SDK directory before installing a new one | 1 or 0 |
| ERASE_ANDROID_NDK | clear NDK directory before installing a new one | 1 or 0 |
| ANDROID_BUILD_TOOLS_FILTER | additionnal build tools versions to install comma separated | 23.0.2,23.0.3 |
| SSL_CERT | path to certificate (*) |
| SSL_KEY | path to key file (*) |
| SSL_DEST | path for the newly created JKS from the certs above (*) |
| SSL_NEW_PASS | newly created keystore password (*) |
(*) required only if using certificates instead of JKS (working with letsencrypt certs)
Example :
```
docker run -p 8080:8080 -p 50000:50000 \
-e "ANDROID_BUILD_TOOLS_FILTER=23.0.2,23.0.3" \
-e "ANDROID_SDK=r25.2.2" \
-e "ANDROID_NDK=android-ndk-r12b" \
-v /home/user/Android/sdk:/opt/android/sdk \
-v /home/user/Android/ndk:/opt/android/ndk \
-v your_home/jenkins_home:/var/jenkins_home bertrandmartel/docker-jenkins-android
```
## docker-compose
https configuration is enabled by default with `keystore.jks` in a `keys` directory :
```
docker-compose up
```
## docker-cloud
Edit `vars-template.sh` configuration, then :
```
source vars-template.sh
envsubst < stackfile-template.yml > stackfile.yml
docker-cloud stack create --name jenkins -f stackfile.yml
docker-cloud start jenkins
```
## Debug
```
docker exec -it jenkins_image bash
```
## Configure Giltab oauth
* In your Gitlab domain go to `Admin` > `Application`
Create a new application with a chosen name and a redirection URI like this :
* `https://your-jenkins-domain:8083/securityRealm/finishLogin`
Then, you will have generated `Application ID` (client ID) and Secret (Client Secret) :
***
***
* Go to `Manage Jenkins` > `Configure Global Security`
Fill up checking `Gitlab Authentication Plugin` in `Access control` :
***
Now, Jenkins user will be authenticated via Gitlab
## Configure Giltab push trigger
In `Manage Jenkins` > `Configure System` :
Gitlab URL is : `https://:`
***
Enter a Gitlab API Token that you got from Gitlab in `Profile Settings` > `Access Tokens` :
***
In your job configuration, Set `GitLab connection` and `Git` repository config as :
* Repository URL : `git@server/repo.git`
* Name : `origin`
* RefSpec : `+refs/heads/*:refs/remotes/origin/* +refs/merge-requests/*/head:refs/remotes/origin/merge-requests/*`
* Branch specifier : `origin/${gitlabSourceBranch}`
***
In `Build Trigger`, set `Build when a changed is pushed to Gitlab` :
***
In your gitlab repository go to `Webhooks` :
Then, set the webhook URL as : `https://:/project/` :
***
## Configure Giltab Logo
In `Manage Jenkins` > `Configure System` :
`Endpoint URL` is : `https://:/api/v3`
***
## Configure Slack notifications
* go to https://my.slack.com/services/new/jenkins-ci
***
In your job configuration, add a Slack Notification `Post Build Action` :
***
## External Links
* gitlab-plugin setup example : https://github.com/jenkinsci/gitlab-plugin/wiki/Setup-Example
* gitlab-oauth-plugin webhook fix : https://github.com/jenkinsci/gitlab-oauth-plugin/pull/6