rancher/os
1
0
Fork 1
mirror of https://github.com/rancher/os.git synced 2025-04-27 19:15:23 +00:00
Code Issues Releases Wiki Activity
Page: Build time customization
Pages
Build time customization Creating and testing os service console images Home How to run multiple user docker daemons How to set up RancherOS CI How to set up RancherOS on Estuary D02 board How to set up a RancherOS CI on an ARM docker host How to use recovery console Mounting multiple disks in iPXE mode Partition recommendations RancherOS v0.10.0 RancherOS v0.8.0 RancherOS v0.9.0 RancherOS v1.0.0 [Deprecated] SELinux
3 Build time customization
Denise edited this page 2016-02-29 20:34:51 -08:00
Table of Contents

You can customize RancherOS before building your own binary distribution of the OS. This gives you the ability to call it <my>OS and provide your own versioning.

os

https://github.com/rancher/os

In the root of the project, you can find these files: build.conf, build.conf.amd64, build.conf.arm. They set the customizable options for the build.

build.conf sets architecture independent options and all of them are required, that means the values should be set.

Example with v0.4.4-dev:

  • IMAGE_NAME=rancher/os - installer docker image name
  • VERSION=v0.4.4-dev - version
  • DFS_IMAGE=rancher/docker:v1.10.2 - docker-from-scratch image, which is used for the skeleton root filesystem
  • SELINUX_POLICY_URL=https://github.com/rancher/refpolicy/releases/download/v0.0.1/policy.29 - the default compiled SELinux policy
  • HOSTNAME_DEFAULT=rancher - default hostname, which is used if none was provided by DHCP or configured by cloud-config
  • OS_IMAGES_ROOT=rancher - system services docker images' name prefix (e.g. rancher/os-console)
  • OS_SERVICES_REPO=https://raw.githubusercontent.com/rancher/os-services - URL where to find an index.yml file listing the "external" system services (e.g. debian-console)
  • OS_RELEASES_YML=https://releases.rancher.com/os/releases.yml - URL to release index for upgrades and rollbacks

build.conf.{arch} set the options for that particular architecture, only

  • COMPILED_KERNEL_URL=https://github.com/rancher/os-kernel/releases/download/Ubuntu-4.2.0-28.33-rancher/linux-4.2.8-ckt3-rancher-x86.tar.gz (optional) - compiled and packaged Linux kernel with modules and firmware
  • DOCKER_BINARY_URL=https://get.docker.com/builds/Linux/x86_64/docker-1.10.2 (required) - URL where to get the docker binary built for that particular architecture

os-images

https://github.com/rancher/os-images

In os-images, build.conf sets the following options:

  • VERSION=v0.4.4-dev - OS version for which we're building the system service images
  • OS_IMAGES_ROOT=rancher - system services docker images' name prefix (e.g. rancher/os-console)
  • OS_BASE_URL_amd64=https://github.com/rancher/os-base/releases/download/v2015.11.1-1/os-base_amd64.tar.xz - os-base for amd64 tarball download URL
  • OS_BASE_SHA1_amd64=098a64ddb42381fc62ba515870aa8dc6ce19002f - os-base for amd64 tarball sha1 hash
  • OS_BASE_URL_arm=https://github.com/rancher/os-base/releases/download/v2015.11.1-1/os-base_arm.tar.xz - os-base for ARM tarball download URL
  • OS_BASE_SHA1_arm=1da38279861aee631a5d41a7ac9835e4f996d843 - os-base for ARM tarball sha1 hash

Resources