Skip to content

Introduction and Explanation for the IaaS Layer #101

Open
@maxwolfs

Description

@maxwolfs

As the Sovereign Cloud Stack (SCS) continues to evolve, there is an increasing need for clear and comprehensive documentation, especially for its Infrastructure as a Service (IaaS) layer. The documentation should serve as resource for new users and contributors, helping them understand the architecture and functionalities of the IaaS layer within the SCS ecosystem and interplay of OSISM. The goal is to create an overview section as seen in the standard SCS-002-v2

├── IaaS Layer
│    ├── Overview
│    │        ├── Architecture
│    │        ├── Compute
│    │        ├── Storage
│    │        ├── Network
│    │        ├── Control
│    │        └── Knowledge
...

within the existing SCS documentation that accomplishes the following:

  1. Provides a detailed introduction to the IaaS layer, explaining its role, benefits, and the problems it solves within the SCS framework. Important: Distinguish two different intros for operators coming from either "OpenStack" or "Virtual Machine Orchestration (VMWare, HyperV, ProxMox – Starting from Scratch)". Compare the already existing Container Layer introduction: https://docs.scs.community/docs/container/
  2. Offers a visual representation of the IaaS layer’s architecture to enhance user comprehension.
  3. Lists the prerequisites for using the IaaS layer, including necessary hardware, software, and technical knowledge for from either "OpenStack" or "Virtual Machine Orchestration (VMWare, HyperV, ProxMox – Starting from Scratch)".
  4. Presents a "Quickstart" guide for new users to get a basic setup running, with step-by-step instructions suitable for testing environments. See section of "Deployment Examples".
  5. Explains how to configure the IaaS layer, detailing the various options, parameters, and settings available.
  6. Guides users on how to contribute to the IaaS layer's development, including issue submission and participation in discussions.

Action Items:

  • Draft an introductory document for the IaaS layer.
  • Develop a comprehensive visual diagram of the IaaS layer's architecture.
  • Compile a list of prerequisites for the IaaS layer setup.
  • Create a "Quickstart" guide for the IaaS layer.
  • Detail the configuration options available for the IaaS layer.
  • Prepare a contribution guide for the IaaS layer.

As a lof of this is covered within the OSISM documentation it is important to distinguish which content should be written from the SCS perspective and what can be implemented via copying content from the OSISM Docs via the docs sync workflow such as the Guides.

The introduction should be aligned with the SCS Documentation structure, reflecting the logical hierarchy and aiding users in navigating the complex SCS ecosystem.

By accomplishing this, we aim to foster a transparent, inclusive community environment and facilitate the onboarding process for new users and contributors to the SCS.

See also: SovereignCloudStack/issues#124

Metadata

Metadata

Assignees

Labels

IaaSIssues or pull requests relevant for Team1: IaaSdocumentationImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions