# Inferit MSVSphere Docker images

This project contains configuration files and tools for building
[official MSVSphere Docker](https://hub.docker.com/r/inferit/msvsphere) images.


## Build requirements

In order to build an MSVSphere Docker image you need an MSVSphere system with
the following packages installed:

```shell
$ sudo dnf install -y anaconda-tui lorax tar
```

You may also need to change SELinux mode to permissive.


## Usage

The [build-image.sh](build-image.sh) tool must be executed from a root user
shell. See it's `--help` for a list of supported arguments.

Here is an MSVSphere 9 default image build example:

```shell
$ sudo ./build-image.sh --release 9 --type default --output ./result
```

The result will be a built rootfs-tarball, a generated Dockerfile and
corresponding build logs:

```shell
$ ls result/9-default/ -1
Dockerfile
logs
msvsphere-9-default.tar.xz
```


## References

* Docker documentation: [Create a base image](https://docs.docker.com/build/building/base-images/)
* RHEL System Design Guide: [Kickstart Reference guide](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/system_design_guide/kickstart-script-file-format-reference_system-design-guide)
* Opencontainers [image-spec annotations/labels](https://github.com/opencontainers/image-spec/blob/master/annotations.md)


## License

Licensed under the MIT license, see the [LICENSE](LICENSE) file for details.


## Authors

* [Eugene Zamriy](https://github.com/ezamriy)