Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

improve provisioning documentation #637

Merged
merged 2 commits into from
Sep 16, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 27 additions & 2 deletions docs/guides/deploy-guide/provisioning.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,34 @@ control plane manually. An ISO image is provided for this purpose which automati
provisions a node. The ISO images are available for download in the
[osism/node-image](https://github.com/osism/node-image) repository.

## Automated Installation using Node Images

There are different variants of the ISO image. The variants differ in the disc layout.
The available variants are described in the README file of the [osism/node-image](https://github.com/osism/node-image)
repository.

The pre-build variants are described in the [osism/node-image](https://github.com/osism/node-image/blob/main/README.md) repository.

A good way to provision the nodes is to use virtual media mounts via the usually available Redfish
functionality of the BMC of the servers used. In this way, the basic installation can be carried
out without external dependencies such as adapting the switch configuration, DHCP, upstream connectivity, etc.
In many cases, this simplifies the process, makes it more automation-friendly and avoids potential sources of error.

OSISM also provides a [tool](https://github.com/osism/node-image?tab=readme-ov-file#creation-of-specific-images) to generate node images specific for you needs.

This makes particular sense for the node-provisioning in the following situations:

* Make complex configurations like layer3 underlay
* Add your SSH keys to the image
* Configure a specific root password
* Change other characteristics of the setup
* Templates
* Partitioning
* Packages
* ...
* Develop new standard images

The procedures for building custom images are described in the
[osism/node-image](https://github.com/osism/node-image/blob/main/README.md) repository.


## Manual provisioning

Expand Down
Loading