- Python 87.7%
- Shell 11.6%
- Dockerfile 0.7%
|
|
||
|---|---|---|
| .github/workflows | ||
| docker | ||
| docs | ||
| examples | ||
| photon_installer | ||
| sample_ks | ||
| tests | ||
| .gitignore | ||
| .shellcheckrc | ||
| CODE-OF-CONDUCT.md | ||
| CONTRIBUTING.md | ||
| create-image-util | ||
| LICENSE-Apachev2 | ||
| LICENSE-GPL2.0 | ||
| lint-checks.sh | ||
| MANIFEST.in | ||
| NOTICE-Apachev2 | ||
| NOTICE-GPL2.0 | ||
| photon-installer.spec | ||
| photon-os-installer.spec | ||
| README.md | ||
| requirements.txt | ||
| setup.cfg | ||
| setup.py | ||
| version.py | ||
Photon OS Installer
What is Photon Installer
Photon OS Installer Project aims to seperate out installer source code from Photon project and use it as a python library. This Project can be used to create a photon-installer binary that can be used to install Photon OS when invoked with appropriate arguments.
Features
- Generates Photon Installer executable.
- Creates Photon Images(ISO, GCE, AMI, AZURE, OVA...).
- Makes Photon Installer Source code installable through pip interface and use it as a python library.
Dependencies
python3, python3-pyinstaller, python3-setuptools
Building from source.
Building Photon Installer Executable on Photon OS
➜ ~ tdnf install -y python3 python3-setuptools python3-pyinstaller
➜ ~ git clone https://github.com/vmware/photon-os-installer.git
➜ ~ cd photon-os-installer
➜ ~ pyinstaller --onefile photon-installer.spec
Building Photon Installer Executable on Other distros
➜ ~ pip3 install setuptools pyinstaller
➜ ~ git clone https://github.com/vmware/photon-os-installer.git
➜ ~ cd photon-os-installer
➜ ~ pyinstaller --onefile photon-installer.spec
The executable generated can be found inside dist directory created.
Currently following images can be built based on architecture mentioned in table.
| x86_64 | arm64 |
|---|---|
| iso | iso |
| ova | ova |
| ova_uefi | ova_uefi |
| minimal-iso | |
| rt-iso | |
| ami | |
| gce | |
| azure | |
| rpi3 |
Building Photon Cloud images using Photon OS Installer
➜ ~ pip3 install git+https://github.com/vmware/photon-os-installer.git
➜ ~ git clone https://github.com/vmware/photon.git
➜ ~ cd photon
➜ ~ make image IMG_NAME=ami
Using Photon OS Installer as python library
install config mentioned below can be referred from Photon Project
import photon_installer
from photon_installer.installer import Installer
import json
with open('path_to_file/config.json') as f:
install_config = json.load(f)
installer = Installer(working_directory='/root/photon/stage/ova', rpm_path='/root/photon/stage/RPMS', log_path='/root/photon/stage/LOGS')
installer.configure(install_config)
installer.execute()
Contributing
The Photon OS Installer project team welcomes contributions from the community. If you wish to contribute code and you have not signed our contributor license agreement (CLA), our bot will update the issue when you open a Pull Request. For any questions about the CLA process, please refer to our FAQ.