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

docs: How-to create WSL instances on multiple Windows machines via Landscape API #928

Merged
merged 12 commits into from
Oct 4, 2024

Conversation

CarlosNihelton
Copy link
Contributor

@CarlosNihelton CarlosNihelton commented Oct 3, 2024

This PR makes heavy use of tabbed code blocks to show alternative ways to do things with Bash and PowerShell.

image

Both alternatives were tested. The bash one comes from the Landscape documentation, I essentially extracted the piece I was more concerned about (custom rootfs with cloud-init data) and made a self-contained guide out of it (plus translating to PowerShell).


UDENG-4694

@CarlosNihelton
Copy link
Contributor Author

CI Link check is now failing mainly due this page about MS Store requirements which no longer exists. I didn't find a suitable replacement for that page so far. Even asked on one MS forum.

@CarlosNihelton CarlosNihelton marked this pull request as ready for review October 3, 2024 19:27
@CarlosNihelton CarlosNihelton requested a review from a team as a code owner October 3, 2024 19:27
docs/howto/index.md Outdated Show resolved Hide resolved
Copy link
Collaborator

@edibotopic edibotopic left a comment

Choose a reason for hiding this comment

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

This is great Carlos -- thank you.

It's also a really excellent use of the tabbed interface.

I have a few minor comments, mostly around wording but nothing major.

I could not find an alternative for that broken MS Store link either -- we may need to just remove it for now.

Rephrased that line a bit to ack the fact that it's still possible
to install custom rootfses from Landscape if MS Store is not accessible.
Landscape docs already feature a quite complete guide on how
to create WSL instances on Windows machines via Landscape API.

Here we take a subset of that documentation and put it in shape for
use with PowerShell (alongside Bash).

This guide's focus is to deploy WSL instances from a custom rootfs
with some cloud-config data for further customisation, using Landscape API
to do it at scale, with both Bash and PowerShell alternatives.

We keep a cross-reference to the existing Landscape docs, which are more
complete.
- Consistent use of periods.
- Link to the config landscape howto.
- "using Bash" instead of "on a Linux machine"
Those links were timing out in CI linkcheck.
The UP4W is only accessible from authorised users logged in,
linkcheck will always fail, thus excluded.
@edibotopic
Copy link
Collaborator

LGTM: thanks for pulling this together!

@CarlosNihelton CarlosNihelton merged commit e82d9cb into main Oct 4, 2024
2 checks passed
@CarlosNihelton CarlosNihelton deleted the htg-landscape-api branch October 4, 2024 14:17
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