Files
openstack-helm-images/mini-mirror/README.rst
Michael Beaver d503870bfe Modify mini-mirror to build from yaml
This modifies mini-mirror so that instead of parsing through .txt
documents to build the mirror, it instead has one yaml file consisting
of multiple yaml documents with a pre-defined structure that has all
of the same information. This will allow for easier modification and
visibility into the configuration of mini-mirror.

Along with that, this enables the manual setting of CodeName and Label
values of the mirror, as well as the ability to change the name of the
image that the build.sh script creates

Change-Id: I08646258492e8938b8892749172aea23e363af3d
2020-01-10 14:34:24 -06:00

2.7 KiB

Mini-mirror Image Build

Mini-mirror is a service that mirrors existing Debian/Ubuntu repositories and can be used as an APT source for OpenStack-Helm deployments with no internet connectivity.

Build Requirements

Add mirror sources

Mini-mirror requires a YAML file at build-time that contains the repositories and packages that will be mirrored as different YAML documents.

*Optional

To specify the location of your sources YAML file, export the following environment variable:

export MIRROR_SOURCE_FILE=/path/to/sources.yaml

Generate a signing key

Warning

The demo image published in the OpenStack-Helm-Addons repository is not signed. It should NOT be used in production and signing should be enabled in the Aptly config file.

Mini-mirror signs the release file during the image build process. Supply a path to a valid GPG key using the RELEASE_SIGN_KEY environment variable.

export RELEASE_SIGN_KEY_PATH=key.gpg

Additionally, supply your GPG key passphrase with the RELEASE_SIGN_KEY_PASSPHRASE environment variable:

export RELEASE_SIGN_KEY_PASSPHRASE=passphrase

Create an Aptly config file (optional)

Specify the location of your Aptly config file using the APTLY_CONFIG_PATH environment variable:

export APTLY_CONFIG_PATH=aptly.conf

Note

Mini-mirror can be configured on a per-repo basis by adding an Aptly config file to the .aptly_config key in the YAML document. This overrides the Aptly config file taken from APTLY_CONFIG_PATH.

Proxy

If building the mini-mirror image behind a proxy server, define the standard HTTP_PROXY, HTTPS_PROXY, and NO_PROXY environment variables. They will be passed as build-args.

Build

To build the mini-mirror image, execute the following:

export DISTRO=ubuntu
./build.sh