site/source/docs/compiling/GitLab.rst

.. _GitLab:

================================
Building and Deploying on GitLab
================================

`GitLab CI/CD <https://about.gitlab.com/product/continuous-integration/>`_ is a popular continuous integration service which offers free plans to everyone. Thanks to an `Alpine Linux package by Jakub Jirutka <https://pkgs.alpinelinux.org/packages?name=emscripten>`_ installing emscripten in GitLab CI/CD is literally a one line task.

A sample .gitlab-ci.yml
=======================

.. code-block:: yaml

    image: alpine:3.9

    before_script:
      - apk add emscripten make --repository=http://dl-cdn.alpinelinux.org/alpine/edge/testing

    pages:
      script:
      - make
      artifacts:
        paths:
        - public
      only:
        - main

Let's break it down:

.. code-block:: yaml

    before_script:
      - apk add emscripten make --repository=http://dl-cdn.alpinelinux.org/alpine/edge/testing

In the before_script stage we download the package from the Alpine Linux testing repository.

This step also contains the command to add an additional build tool *make*.

.. code-block:: yaml

    script:
      - make

In the script stage we can now run the commands we want. In this sample we are using *make*, but you can call *emcc* directly if you prefer.

For an example of this setup in practice, see `the Example Emscripten site using GitLab Pages <https://pages.gitlab.io/emscripten>`_.