Skip to content

Add documentation on creating cluster templates#16

Open
larsks wants to merge 1 commit intoosac-project:mainfrom
larsks:docs/templates
Open

Add documentation on creating cluster templates#16
larsks wants to merge 1 commit intoosac-project:mainfrom
larsks:docs/templates

Conversation

@larsks
Copy link
Copy Markdown
Member

@larsks larsks commented Oct 2, 2025

This adds some early documentation on how to create and utilize cluster
templates.

Closes osac-project/issues#176

@larsks larsks requested a review from IsaiahStapleton October 2, 2025 21:31
This adds some early documentation on how to create and utilize cluster
templates.

Closes osac-project/issues#176
podman push cloudkit-aap-ee quay.io/myusername/cloudkit-aap-ee:latest
```

### Configure the installer to use the new image
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

This part isn't up to date, it should look like this now:


secretGenerator:
  - name: config-as-code-ig
    options:
      disableNameSuffixHash: true
    literals:
      - AAP_EE_IMAGE=ghcr.io/isaiahstapleton/cloudkit-aap:678b9a1514ee800b0429569cbec30a928b167f7e

configMapGenerator:
  - name: publish-templates-ig
    options:
      disableNameSuffixHash: true
    literals:
      - CLOUDKIT_TEMPLATE_COLLECTIONS=cloudkit.templates,isaiahstapleton.ai_cluster_ansible


### Create a role

A cluster template role consists of at least two playbooks:
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Aren't delete.yaml and install.yaml also required?

@@ -0,0 +1,220 @@
# Cluster templates
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Should these template docs include instructions for actually creating cluster request with that new template? Like here: https://gist.github.com/larsks/d90063a98cb7733a5997058d768eed48#creating-a-cluster. Or will that be located in different section of the docs?


There are two steps to making your collection available to the OSAC installer:

1. Build a new [execution environment] that includes your collection.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I also think this step should include the steps for building execution environment from github actions. Building from the github actions that was already constructed, to me, was the most straightforward way to build the execution environment. Mostly because it handles building AND pushing the image.

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.

Add documentation for creating cluster templates

2 participants