debian-image-builder-frontend/devel
Gianluca Zuccarelli bc05bdc0ac devel: update prometheus config
Enable prometheus scraping of the composer endpoints of the
composer instance, which is then used for the composer grafana
dashboard.
2021-10-29 11:02:22 +01:00
..
config devel: update prometheus config 2021-10-29 11:02:22 +01:00
.env devel: add full-stack development environment 2021-05-21 19:23:14 +02:00
.gitignore devel: add full-stack development environment 2021-05-21 19:23:14 +02:00
docker-compose.yml devel: update prometheus config 2021-10-29 11:02:22 +01:00
gen-certs.sh devel: add full-stack development environment 2021-05-21 19:23:14 +02:00
README.md devel: prometheus-grafana integration 2021-09-29 22:02:27 +02:00
setup.sh devel: add full-stack development environment 2021-05-21 19:23:14 +02:00

devtools

Development Tools for Image Builder

Setup

To start local development, first clone the image bulider stack:

git clone git@github.com:osbuild/osbuild.git
git clone git@github.com:osbuild/osbuild-composer.git
git clone git@github.com:osbuild/image-builder.git
git clone git@github.com:osbuild/image-builder-frontend.git

Secondly redirect a few domains to localhost. One for each environment of cloud.redhat.com that exists. You only need the ones you will be developing against. If you are outside the Red Hat VPN, only prod is available:

echo "127.0.0.1 prod.foo.redhat.com" >> /etc/hosts
echo "127.0.0.1 qa.foo.redhat.com" >> /etc/hosts
echo "127.0.0.1 ci.foo.redhat.com" >> /etc/hosts
echo "127.0.0.1 stage.foo.redhat.com" >> /etc/hosts

Lastly run the setup tool from image-builder-frontend to generate TLS certs and potentially other runtime configuration.

cd image-builder-frontend/devel
./setup.sh

Environment Variables

For the Image Builder backend to upload successfully, you need to set some environment variables. For AWS, for example, set the following environment variables in the .env file:

OSBUILD_AWS_REGION
OSBUILD_AWS_ACCESS_KEY_ID
OSBUILD_AWS_SECRET_ACCESS_KEY
OSBUILD_AWS_S3_BUCKET

And then add to the list of environment variables for the backend container in the docker-compose.yml file.

The config variables for the Image Builder backend can be found here.

Run

docker-compose up --build

Access the service through the GUI: https://prod.foo.redhat.com:1337/beta/insights/image-builder, or directly through the API: https://prod.foo.redhat.com:1337/docs/api/image-builder.

Access the Grafana dashboard on https://localhost:3000. The default username is admin and the password is set to foobar.