gardner/hhvm-docker

Dockerfiles for HHVM

This repository contains the sources for the following docker hub images:

• hhvm/hhvm
• hhvm/hhvm-proxygen

Building A New Version

When a new version of HHVM is released:

Update The Base Image

This is built on top of ubuntu:14.04, so make sure you're building against the latest version of that:

$ docker pull ubuntu:14.04

Change The hhvm/hhvm Version Number

For example, for 3.8.0 => 3.8.1:

diff --git a/hhvm-latest/Dockerfile b/hhvm-latest/Dockerfile
index 185d896..17644e0 100644
--- a/hhvm-latest/Dockerfile
+++ b/hhvm-latest/Dockerfile
@@ -4,4 +4,4 @@ RUN apt-get update -y
 RUN apt-get install -y software-properties-common
 RUN apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0x5a16e7281be7
 RUN add-apt-repository "deb http://dl.hhvm.com/ubuntu trusty main"
-RUN apt-get update -y && apt-get install -y hhvm=3.8.0~trusty
+RUN apt-get update -y && apt-get install -y hhvm=3.8.1~trusty

Build And Tag hhvm/hhvm

The ID will not match; be sure to tag your new image ID instead of copying the one in this example.

$ docker build hhvm-latest/
...
Successfully built ba93944aeef2
$ docker tag ba93944aeef2 hhvm/hhvm:latest
$ docker tag ba93944aeef2 hhvm/hhvm:3.8.1

If this is an LTS release, also tag x.y-lts-latest, eg:

$ docker tag 8fa8a82a5f51 hhvm/hhvm:3.9-lts-latest

Change The hhvm/hhvm-proxygen Version Number

diff --git a/hhvm-latest-proxygen/Dockerfile b/hhvm-latest-proxygen/Dockerfile
index b632379..a6aa0ee 100644
--- a/hhvm-latest-proxygen/Dockerfile
+++ b/hhvm-latest-proxygen/Dockerfile
@@ -1,4 +1,4 @@
-FROM hhvm/hhvm:3.8.0
+FROM hhvm/hhvm:3.8.1

 RUN mkdir -p /var/www/public

Build And Tag hhvm/hhvm-proxygen

$ docker build hhvm-latest-proxygen/
Sending build context to Docker daemon 3.584 kB
Sending build context to Docker daemon
Step 0 : FROM hhvm/hhvm:3.8.1
 ---> ba93944aeef2
...
Successfully built b85395df4dc7
$ docker tag b85395df4dc7 hhvm/hhvm-proxygen:latest
$ docker tag b85395df4dc7 hhvm/hhvm-proxygen:3.8.1

If this is an LTS release, also tag x.y-lts-latest, eg:

$ docker tag 29d782b1b052 hhvm/hhvm-proxygen:3.9-lts-latest

Test

Test with an arbitrary website. If you have a site with index.php in the root:

~/mysite$ docker run --name=3.8.1_test -v $(pwd):/var/www/public -d -P hhvm/hhvm-proxygen:latest
e6e108f83a7421d6163c27d70bcd0ea7a801546a555e503f1bbb9c055377df87
~/mysite$ docker port 3.8.1_test 80
0.0.0.0:49153

Then run your test suite against the port that docker gives you - http://localhost:49153 for the example above.

To clean up your tests:

$ docker stop 3.8.1_test
$ docker rm 3.8.1_test

Sanity-Check

$ docker images | grep hhvm/hhvm
hhvm/hhvm-proxygen   3.8.1               b85395df4dc7        12 minutes ago      469.9 MB
hhvm/hhvm-proxygen   latest              b85395df4dc7        12 minutes ago      469.9 MB
hhvm/hhvm            3.8.1               ba93944aeef2        16 minutes ago      469.9 MB
hhvm/hhvm            latest              ba93944aeef2        16 minutes ago      469.9 MB
hhvm/hhvm-proxygen   3.8.0               78844bf6551e        43 hours ago        470.9 MB
hhvm/hhvm            3.8.0               53363d5764e8        2 days ago          470.9 MB

Check for typos, and make sure that the IDs and timestamps for 'latest' and the new version match.

Push To DockerHub

$ docker push hhvm/hhvm
The push refers to a repository [hhvm/hhvm] (len: 3)
Sending image list
Pushing repository hhvm/hhvm (3 tags)
...
ba93944aeef2: Image successfully pushed
Pushing tag for rev [ba93944aeef2] on {https://cdn-registry-1.docker.io/v1/repositories/hhvm/hhvm/tags/3.8.1}
Pushing tag for rev [ba93944aeef2] on {https://cdn-registry-1.docker.io/v1/repositories/hhvm/hhvm/tags/latest}
$ docker push hhvm/hhvm-proxygen
The push refers to a repository [hhvm/hhvm-proxygen] (len: 3)
Sending image list
Pushing repository hhvm/hhvm-proxygen (3 tags)
...
b85395df4dc7: Image successfully pushed
Pushing tag for rev [b85395df4dc7] on {https://cdn-registry-1.docker.io/v1/repositories/hhvm/hhvm-proxygen/tags/3.8.1}
Pushing tag for rev [b85395df4dc7] on {https://cdn-registry-1.docker.io/v1/repositories/hhvm/hhvm-proxygen/tags/latest}

Push Updated Sources

$ git commit -m 'v3.8.1'
$ git push