Skip to content
Snippets Groups Projects
Select Git revision
  • improve-ci
  • 36-new-stable-nginx-release-1-26-3
  • master default protected
  • 29-rebase-on-openresty-1-21-4-1
4 results
Compare
Francesco Giacomini's avatar
Be sure that CI_PROJECT_DIR is an environment variable.
Francesco Giacomini authored 
Do not restore a working directory at the end of the function, since
there was no previous directory change.
7a26c5eb
History
Francesco Giacomini's avatar 7a26c5eb
History
Name Last commit Last update
..
assets
library-scripts
Dockerfile
README.md
devcontainer.json
README.md

ngx_http_voms_module for developers

A devcontainer is ready to use for the developers. A set of packages without nginx are already installed.

How to build and install nginx with or without httpg patch

To build and install the latest stable version of nginx you have to copy the nginx.repo file (it is contained in the docker directory) into the /etc/yum.repos.d/ directory and install nginx with yum:

$ sudo cp docker/nginx.repo /etc/yum.repos.d/
$ sudo yum install -y nginx

Otherwise, if you want to build and install the latest stable version of nginx with the httpg patch, a bash library is ready to use. You can source it and follow the commands below:

$ source .devcontainer/assets/build-library.sh
$ downloadNginx
$ buildHttpgNginxRPM
$ sudo rpm -ivh ~/rpmbuild/RPMS/x86_64/nginx-*.httpg.x86_64.rpm

How to build and install the ngx_http_voms_module

If you want to build and install the ngx_http_voms_module, nginx have to be installed in the container (see the previous section). When this requirement is satisfied, you can use the library contained in the .devcontainer/assets folder as follows (NOTE: if you have already download nginx source file, you can skip the relative command):

$ source .devcontainer/assets/build-library.sh
$ downloadNginx
$ buildVomsModuleRPM
$ sudo rpm -ivh ~/rpmbuild/RPMS/x86_64/nginx-module-http-voms-*.x86_64.rpm

How to manage this project

If you want to understand how this project works, start from the CI. Three stages are defined:

1. build-rpms

Starting from a clear AlmaLinux 9, we install all the useful packages to compile nginx and to build a rpm package. The bash steps that achieves these results are defined in the .devcontainer/assets/build-library.sh file, so you can read that bash script to learn which nginx version we use, how to download it, how to set up the environment and how to build the rpm.

It is important to underline that to build the nginx rpm we use the spec file in the rpm repo, that is the official nginx 1.24.0 spec file increased by the HTTPG patch. To build the ngx_http_voms_module we have defined an appropriate spec file indeed. The files that are used to build the rpm module are written, called and collocated following the common practices of the nginx modules: a source file is defined in the src folder, the config and the config.make files are in the root project directory.

At the end of this stage, all the useful rpms are saved as job artifacts.

2. docker-build-rpms

In this stage we set up a docker image with nginx, the httpg patch and the ngx_http_voms_module. To do this, we use a set of scripts written by Andrea Ceccanti in the helper-scripts project.

The dockerfile and all the files needed for its compilation are in the docker directory. The image starts from AlmaLinux 9, defines a user and installs a set of useful packages. After that we import the nginx repo file, in this way we can download a lot of packages provided by nginx, including its last stable version. In the end we install the rpm packages that we build in the previous stage and the njs module.

3. push-to-dockerhub

In this last stage we push on dockerhub the image that we have builded in the previous stage. Note that this stage is run only when we push something in the master branch.