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

Update docs for Advanced Bare Metal cluster configuration: #8831

Merged
merged 14 commits into from
Oct 7, 2024

Conversation

jacobweinstock
Copy link
Member

Issue #, if available:

Description of changes:

We changed to embedded images which necessitated the doc update.

Testing (if applicable):

Documentation added/planned (if applicable):

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

We changed to embedded images which necessitated the
doc update.

Signed-off-by: Jacob Weinstock <jakobweinstock@gmail.com>
@eks-distro-bot eks-distro-bot added the size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. label Oct 4, 2024
Copy link

codecov bot commented Oct 4, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 73.66%. Comparing base (eb0b793) to head (eca5ec6).
Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #8831   +/-   ##
=======================================
  Coverage   73.66%   73.66%           
=======================================
  Files         578      578           
  Lines       36618    36618           
=======================================
  Hits        26973    26973           
  Misses       7919     7919           
  Partials     1726     1726           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@jacobweinstock
Copy link
Member Author

/approve

@eks-distro-bot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: jacobweinstock

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

Copy link
Member

@chrisnegus chrisnegus left a comment

Choose a reason for hiding this comment

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

I don't know how to check the config examples, so I just did a copy edit. Looks good. Mostly small suggestions.

@@ -481,7 +468,7 @@ spec:
version: "0.1"
```

### RHEL TinkerbellTemplateConfig example
### Redhat
Copy link
Member

Choose a reason for hiding this comment

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

We are a bit inconsistent with how we use "Red Hat" in our docs. I'd suggest using "Red Hat" if you mean the company, "Red Hat Enterprise Linux" if you mean the OS, or "redhat" if you mean the option you use on the command line. If you mean to include other RHEL clones, maybe say something like "Red Hat Enterprise Linux or compatible OS".

By creating your own custom Tinkerbell actions, you can add to or modify the installed operating system so those changes take effect when the installed system first starts (from a reboot or pivot).
The following example shows how to add a .deb package (`openssl`) to an Ubuntu installation:

The following example shows how to add a .deb package (`openssl`) to a Redhat installation:
Copy link
Member

Choose a reason for hiding this comment

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

Probably "Red Hat", but see my note about different ways to refer to it.

jacobweinstock and others added 13 commits October 7, 2024 10:25
Co-authored-by: Chris Negus <striker57@gmail.com>
Co-authored-by: Chris Negus <striker57@gmail.com>
Co-authored-by: Chris Negus <striker57@gmail.com>
Co-authored-by: Chris Negus <striker57@gmail.com>
Co-authored-by: Chris Negus <striker57@gmail.com>
Co-authored-by: Chris Negus <striker57@gmail.com>
Co-authored-by: Chris Negus <striker57@gmail.com>
Co-authored-by: Chris Negus <striker57@gmail.com>
Co-authored-by: Chris Negus <striker57@gmail.com>
Co-authored-by: Chris Negus <striker57@gmail.com>
Signed-off-by: Jacob Weinstock <jakobweinstock@gmail.com>
Signed-off-by: Jacob Weinstock <jakobweinstock@gmail.com>
Signed-off-by: Jacob Weinstock <jakobweinstock@gmail.com>
@chrisnegus
Copy link
Member

/lgtm

@eks-distro-bot eks-distro-bot merged commit 9f63b0c into aws:main Oct 7, 2024
9 checks passed
Pay special attention to the `BOOTCONFIG_CONTENTS` environment section below if you wish to set up console redirection for the kernel and systemd.
If you are only using a direct attached monitor as your primary display device, no additional configuration is needed here.
However, if you need all boot output to be shown via a server's serial console for example, extra configuration should be provided inside `BOOTCONFIG_CONTENTS`.
Each Action has its own set of environment variables that are used to configure the Action. EKS Anywhere embeds a set of images into HookOS. This means that when these images are used in an Action they will not be pulled from any external registry. No external network communication is needed to use them. These Actions are prefixed with `127.0.0.1/embedded`.
Copy link
Member

Choose a reason for hiding this comment

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

does user still have the option to pull images from public ecr like in the example before? If yes do we want to add an example of pulling from public ecr?

Copy link
Member Author

@jacobweinstock jacobweinstock Oct 7, 2024

Choose a reason for hiding this comment

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

Yes. Users can pull images from anywhere they want. I think if that wasn't clear then I should update the doc to make that more clear.

In regard to providing an explicit example for pulling from ECR, I don't think we should. The whole idea of the embedded images is that pulling from ECR is not necessary. Also, there is not "latest" images in ECR for all the images. Each release we do has a new ECR location for images. Keeping these up to date in the docs adds to the already full load of work required for each release and we have opted to not do this. This would also mean that any exact reference provided in the docs would quickly be out of date.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved area/docs Documentation documentation lgtm size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants