Skip to content

Operational model #38

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

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Operational model #38

wants to merge 4 commits into from

Conversation

mglantz
Copy link
Contributor

@mglantz mglantz commented Jun 5, 2025

I'm sorry for the big bang, but this is something useful. It's an operational model for Red Hat Enterprise Linux, inspired from some previous work I did for an operational model for AAP. It covers the people, process and technology aspects of running a standard platform based on Red Hat Enterprise Linux. There's room for refinements I'm sure, but it's a good starting point and provides a significant chunk of content for our site (which I think we need).

mkdocs.yml Outdated
- Operational Model:
- What is an operational model: operational-model/intro.md
- Minimal Viable Product: operational-model/mvp.md
- 2.0: operational-model/twozero.md
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Needs to be quoted like "2.0" or it errors out:

ERROR   -  Error reading page 'operational-model/twozero.md': argument of type 'float' is not iterable
Traceback (most recent call last):
  File "/opt/app-root/bin/mkdocs", line 8, in <module>
    sys.exit(cli())
             ^^^^^
  File "/opt/app-root/lib64/python3.12/site-packages/click/core.py", line 1442, in __call__
    return self.main(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/app-root/lib64/python3.12/site-packages/click/core.py", line 1363, in main
    rv = self.invoke(ctx)
         ^^^^^^^^^^^^^^^^
  File "/opt/app-root/lib64/python3.12/site-packages/click/core.py", line 1830, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/app-root/lib64/python3.12/site-packages/click/core.py", line 1226, in invoke
    return ctx.invoke(self.callback, **ctx.params)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/app-root/lib64/python3.12/site-packages/click/core.py", line 794, in invoke
    return callback(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/app-root/lib64/python3.12/site-packages/mkdocs/__main__.py", line 272, in serve_command
    serve.serve(**kwargs)
  File "/opt/app-root/lib64/python3.12/site-packages/mkdocs/commands/serve.py", line 85, in serve
    builder(config)
  File "/opt/app-root/lib64/python3.12/site-packages/mkdocs/commands/serve.py", line 67, in builder
    build(config, serve_url=None if is_clean else serve_url, dirty=is_dirty)
  File "/opt/app-root/lib64/python3.12/site-packages/mkdocs/commands/build.py", line 310, in build
    _populate_page(file.page, config, files, dirty)
  File "/opt/app-root/lib64/python3.12/site-packages/mkdocs/commands/build.py", line 163, in _populate_page
    page.markdown = config.plugins.on_page_markdown(
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/app-root/lib64/python3.12/site-packages/mkdocs/plugins.py", line 635, in on_page_markdown
    return self.run_event('page_markdown', markdown, page=page, config=config, files=files)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/app-root/lib64/python3.12/site-packages/mkdocs/plugins.py", line 566, in run_event
    result = method(item, **kwargs)
             ^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/app-root/lib64/python3.12/site-packages/mkdocs_macros/plugin.py", line 935, in on_page_markdown
    if "{" in page.title:
       ^^^^^^^^^^^^^^^^^
TypeError: argument of type 'float' is not iterable

An overview of a common onboarding process can be viewed below. Please note that the graphics describes all three advancement levels of onboarding.
![Overview](assets/rhel-onboarding.jpg)

The steps for the MVP version of the onboarding process follows:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These looks like they need an additional new line to be properly formatted

![Overview](assets/rhel-onboarding.jpg)

The steps for the 2.0 version of the onboarding process follows:
* **Automated onboarding** - Configuration required to provide access to a new team is performed automatically. This includes creation of LDAP groups, adding users and configuring systems to provide access to the newly onboarded team.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These looks like they might need an additional new line to be properly formatted

@mglantz
Copy link
Contributor Author

mglantz commented Jun 11, 2025

Alright, fixed these things.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants