feat: add common build environment

Add a build environment based on container images that can reproduce
the build in multiple environments.

Signed-off-by: Rafael Fernández López <[email protected]>

.dockerignore

@@ -0,0 +1 @@
+/php

.github/workflows/build-php.yaml

@@ -0,0 +1,28 @@
+name: Build PHP
+on:
+  push:
+    # By specifying branches explicitly, we avoid this workflow from
+    # running on tag push. We have a dedicated workflow to be ran when
+    # a tag is pushed.
+    branches:
+      - "*"
+  pull_request:
+jobs:
+  build-php:
+    strategy:
+      fail-fast: false
+      matrix:
+        versions:
+          - php: 7.3.33
+          - php: 7.4.32
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+      - name: Build PHP
+        run: make php/php-${{ matrix.versions.php }}
+      - name: Upload php-cgi-${{ matrix.versions.php }}.wasm artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: php-cgi-${{ matrix.versions.php }}.wasm
+          path: php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi

.github/workflows/release-php.yaml

@@ -0,0 +1,67 @@
+name: Release PHP
+on:
+  push:
+    tags:
+      - php/*
+jobs:
+  release-php:
+    strategy:
+      fail-fast: false
+      matrix:
+        versions:
+          - php: 7.3.33
+          - php: 7.4.32
+    runs-on: ubuntu-latest
+    env:
+      BINARYEN_VERSION: 110
+    steps:
+      - name: Checkout repository
+        # This if could be moved to the parent `job` section when it's
+        # supported by GitHub (https://github.com/community/community/discussions/37883)
+        if: github.event.ref == format('refs/tags/php/{0}', matrix.versions.php)
+        uses: actions/checkout@v3
+      - name: Build PHP
+        # This if could be moved to the parent `job` section when it's
+        # supported by GitHub (https://github.com/community/community/discussions/37883)
+        if: github.event.ref == format('refs/tags/php/{0}', matrix.versions.php)
+        run: make php/php-${{ matrix.versions.php }}
+      - name: Rename release artifacts
+        # This if could be moved to the parent `job` section when it's
+        # supported by GitHub (https://github.com/community/community/discussions/37883)
+        if: github.event.ref == format('refs/tags/php/{0}', matrix.versions.php)
+        shell: bash
+        run: |
+          sudo mv php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi{,.wasm}
+      - name: Setup binaryen
+        # This if could be moved to the parent `job` section when it's
+        # supported by GitHub (https://github.com/community/community/discussions/37883)
+        if: github.event.ref == format('refs/tags/php/{0}', matrix.versions.php)
+        shell: bash
+        run: |
+          wget https://github.com/WebAssembly/binaryen/releases/download/version_${{ env.BINARYEN_VERSION }}/binaryen-version_${{ env.BINARYEN_VERSION }}-x86_64-linux.tar.gz
+          tar -xf binaryen-version_${{ env.BINARYEN_VERSION }}-x86_64-linux.tar.gz --strip-components=1 -C /opt
+          rm binaryen-version_${{ env.BINARYEN_VERSION }}-x86_64-linux.tar.gz
+      - name: Optimize release artifacts
+        # This if could be moved to the parent `job` section when it's
+        # supported by GitHub (https://github.com/community/community/discussions/37883)
+        if: github.event.ref == format('refs/tags/php/{0}', matrix.versions.php)
+        shell: bash
+        run: |
+          sudo /opt/bin/wasm-opt -Os -o php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi.size-optimized.wasm php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi.wasm
+          sudo /opt/bin/wasm-opt -O -o php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi.speed-optimized.wasm php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi.wasm
+      - name: Append version to release artifacts
+        if: github.event.ref == format('refs/tags/php/{0}', matrix.versions.php)
+        run: |
+          sudo mv php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi{,-${{ matrix.versions.php }}}.wasm
+          sudo mv php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi{,-${{ matrix.versions.php }}}.size-optimized.wasm
+          sudo mv php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi{,-${{ matrix.versions.php }}}.speed-optimized.wasm
+      - name: Release
+        # This if could be moved to the parent `job` section when it's
+        # supported by GitHub (https://github.com/community/community/discussions/37883)
+        if: github.event.ref == format('refs/tags/php/{0}', matrix.versions.php)
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi-${{ matrix.versions.php }}.wasm
+            php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi-${{ matrix.versions.php }}.size-optimized.wasm
+            php/build-output/php/php-${{ matrix.versions.php }}/bin/php-cgi-${{ matrix.versions.php }}.speed-optimized.wasm

.gitignore

@@ -1,6 +1,6 @@
-# Ignore everything in this directory
-build-output/**
-build-staging/**
+# Ignore everything in these directories
+build-output
+build-staging
 .vscode/**
 *.log
 # Except this file

Dockerfile.wasi-builder

@@ -0,0 +1,19 @@
+FROM ubuntu:latest@sha256:4b1d0c4a2d2aaf63b37111f34eb9fa89fa1bf53dd6e4ca954d47caebca4005c2
+ARG WASI_SDK_VERSION=16
+ENV WASI_SDK=wasi-sdk-${WASI_SDK_VERSION}
+ENV WASI_SDK_ROOT=/wasi-sdk
+RUN apt update && \
+      DEBIAN_FRONTEND=noninteractive apt install -y \
+        autoconf \
+        automake \
+        build-essential \
+        clang \
+        git \
+        pkg-config \
+        wget
+RUN wget https://github.com/WebAssembly/wasi-sdk/releases/download/${WASI_SDK}/${WASI_SDK}.0-linux.tar.gz && \
+      mkdir /wasi-sdk && \
+      tar xf ${WASI_SDK}.0-linux.tar.gz --strip-components=1 -C ${WASI_SDK_ROOT} && \
+      rm ${WASI_SDK}.0-linux.tar.gz
+ADD . /wlr
+WORKDIR /wlr

Makefile

@@ -0,0 +1,9 @@
+# This Makefile contains the main targets for all supported language runtimes
+
+.PHONY: php/php-*
+php/php-*:
+	make -C php $(subst php/php-,php-,$@)
+
+.PHONY: clean
+clean:
+	make -C php clean

Makefile.builders

@@ -0,0 +1,5 @@
+BUILDER_ROOT_DIR := $(dir $(realpath $(lastword $(MAKEFILE_LIST))))
+
+.PHONY: wasi-builder-16
+wasi-builder-16:
+	docker build --build-arg WASI_SDK_VERSION=16 -f ${BUILDER_ROOT_DIR}/Dockerfile.wasi-builder -t ghcr.io/vmware-labs/wasi-builder:16 ${BUILDER_ROOT_DIR}

README.md

@@ -7,33 +7,30 @@ compiled for the wasm32-wasi target.
 
 ## Getting started
 
-To run this builds for WASM/WASI you will need to install [WebAssembly/wasi-sdk](https://github.com/WebAssembly/wasi-sdk) in advance. Then export the location as `WASI_SDK_ROOT`.
+All you need in order to run these builds is to have `docker` or
+`podman` available in your system. You can execute the following
+`Makefile` targets:
 
-First ensure you have the build tools required to build the respective language runtime or standalone library. These could be `autoconf`, `libtool`, `make`, etc.
+- `php/php-7.3.33`
+    - Resulting binaries are placed in `php/build-output/php/php-7.3.33/bin`.
 
-For the current version of our build orchestration scripts we use `bash`
+- `php/php-7.4.32`
+    - Resulting binaries are placed in `php/build-output/php/php-7.4.32/bin`.
 
-Just call the `wl-make.sh` script for the folder with the tagged version of whatever you want to build
+### Build strategy
 
-```console
-./wl-make.sh php/php-7.4.32
-```
-
-or 
-
-```console
-./wl-make.sh libs/sqlite/version-3.39.2
-```
+If you are interested in knowing more about the build system and how
+it produces the final binaries, keep reading.
 
-## Code Organization
+### Code Organization
 
 All build orchestration scripts are written in bash in this initial version. The start with a `wl-` prefix (short for WasmLabs). Review the [build orchestration scripts](#build-orchestration-scripts) section for more info.
 
-All intermediary source code checkouts and build objects get created within the `build-staging` folder. The final output gets written to the `build-output` folder. 
+All intermediary source code checkouts and build objects get created within the `build-staging` folder. The final output gets written to the `build-output` folder.
 
 The patches and scripts to build different language runtimes are organized in a folder hierarchy that follows the tagged versions from the respective source code repositories. Several `wl-` scripts are added around that to facilitate setup of a local clone of the repository, application of respective patches and building with respective build configuration options.
 
-For language runtimes we have something like this. 
+For language runtimes we have something like this.
 
 ```
 $LANGUAGE_RUNTIME_NAME (e.g. php)
@@ -62,7 +59,7 @@ libs (common libraries, needed by different modules)
     └── wl-env-repo.sh (script that sets up the source code repository for given langauge and tag)
 ```
 
-## Build orchestration scripts
+### Build orchestration scripts
 
 1. The main script used to build something is `wl-make.sh` in the root folder. It gets called with a path to the folder for a respective tag of what we want to build
 
@@ -74,7 +71,7 @@ libs (common libraries, needed by different modules)
 
 5. Before building this will call a `$LANG/$TAG/wl-build-deps.sh` if there is any to build required dependencies and setup CFLAGS or LDFLAGS for their artifacts. Then it will call the `$LANG/$TAG/wl-build.sh` script to build the actual target itself.
 
-## Adding a new build target
+### Adding a new build target
 
 To add a build setup for a new version of something that is already configured:
 
@@ -92,7 +89,7 @@ touch php/php-7.3.33/wl-build.sh
 
 3. Setup your build environment via `scripts/wl-env.sh` with the target path then query the respective environment variables, like this:
 
-```console 
+```console
 source scripts/wl-env.sh php/php-7.3.33
 export | grep WASMLABS_
 ```
@@ -140,3 +137,16 @@ scripts/wl-update-patches.sh
 git add php/php-7.3.33
 git commit -m "Add support to build php version 7.3.33"
 ```
+
+## Performing a release
+
+In order to perform a release, push a tag of the following form
+depending on the project artifacts you want to be built and published:
+
+- `php/version`, where version can be any of:
+    - `7.3.33`
+    - `7.4.32`
+
+When the tag is pushed to the repository, a GitHub release will be
+created automatically, and relevant artifacts will be automatically
+published to the release.

libs/sqlite/README.md

@@ -1,22 +1,3 @@
 # About
 
-Build scripts and patches for the sqlite3 library.
-# Prerequisites
-
-1. All build operations rely on WASISDK. You could get it from here - https://github.com/WebAssembly/wasi-sdk
-
-2. The sqlite build uses autoconf make and libtool. On a ubuntu machine you may need to do
-
-```console
-sudo apt update && sudo apt install autoconf make libtool-bin -y
-```
-
-3. Before building define WASI_SDK_ROOT to point to a local installation of WasiSDK. For example
-
-```console
-export WASI_SDK_ROOT=/opt/wasi-sdk
-```
-
-# References
-
 The patch and approach have been greatly influenced by the changes in [rcarmo/wasi-sqlite](https://github.com/rcarmo/wasi-sqlite)

php/.dockerignore

@@ -0,0 +1,2 @@
+build-output
+build-staging

php/Dockerfile

@@ -0,0 +1,8 @@
+ARG WASI_SDK_VERSION=16
+FROM ghcr.io/vmware-labs/wasi-builder:${WASI_SDK_VERSION}
+RUN DEBIAN_FRONTEND=noninteractive apt install -y \
+      bison \
+      re2c \
+      libsqlite3-dev \
+      tcl
+ADD . /wlr/php

php/Makefile

@@ -0,0 +1,18 @@
+WASI_SDK_VERSION ?= 16
+
+ROOT_DIR := $(dir $(realpath $(lastword $(MAKEFILE_LIST))))
+
+include ../Makefile.builders
+
+.PHONY: php-builder
+php-builder: wasi-builder-16
+	docker build -f ${ROOT_DIR}/Dockerfile --build-arg WASI_SDK_VERSION=$(WASI_SDK_VERSION) -t ghcr.io/vmware-labs/php-builder:wasi-$(WASI_SDK_VERSION) ${ROOT_DIR}
+
+.PHONY: php-*
+php-*: php-builder
+	mkdir -p build-output build-staging
+	docker run --rm -v ${ROOT_DIR}/build-output:/wlr/build-output -v ${ROOT_DIR}/build-staging:/wlr/build-staging ghcr.io/vmware-labs/php-builder:wasi-${WASI_SDK_VERSION} ./wl-make.sh php/$@
+
+.PHONY: clean
+clean:
+	rm -rf build-output build-staging

php/README.md

@@ -1,46 +1,6 @@
 # About
 
-Basic instructions on how to build different php versions.
-
-# Prerequisites
-
-1. All build operations rely on WASISDK. You could get it from here - https://github.com/WebAssembly/wasi-sdk
-
-2. The php build uses autoconf make and libtool. On a ubuntu machine you may need to do
-
-```console
-sudo apt update && sudo apt install autoconf make libtool-bin -y
-```
-
-3. Before building define WASI_SDK_ROOT to point to a local installation of WasiSDK. For example
-
-```console
-export WASI_SDK_ROOT=/opt/wasi-sdk
-```
-
-# 7.3.33 - patch.v2.diff
-
-This is work in progress and we're currently building only php-cgi.
-
-**Note**: A build with this patch has some issues interpreting WP. We are working on it. 
-
-1. To build just run `php/patches/7.3.33/build.sh`
-
-2. You can find `php-cgi` in `$WASMLABS_BUILD_OUTPUT/bin/php-cgi`
-
-# 7.4.32 - patch.v1.diff
-
-This is work in progress and we're currently building only php-cgi.
-
-This build also downloads and builds sqlite3(3.39.2) and links it into the php binary
-
-**Note**: A build with this patch has some issues interpreting WP. We are working on it. 
-
-1. To build just run `php/patches/7.4.32/build.sh`
-
-2. You can find `php-cgi` in `$WASMLABS_BUILD_OUTPUT/bin/php-cgi`
-
-# Running a script with php-cgi
+## Running a script with php-cgi
 
 Don't forget to map the folder that contains the php script, which you want to run. For example: