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

Add applehv provisioning documentation #711

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Conversation

baude
Copy link
Contributor

@baude baude commented Feb 27, 2025

Now that vfkit makes it easy to inject ignition files while booting FCOS, we can add some simple documentation for provisioning. This one is a hybrid between the hyperv and qemu provisioning documents.

@baude
Copy link
Contributor Author

baude commented Feb 27, 2025

@cfergeau PTAL

Copy link

@cfergeau cfergeau left a comment

Choose a reason for hiding this comment

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

a few minor comments, but looks good to me!

When FCOS is completed booting, you will see the IP address of the VM displayed in the GUI window. Vfkit will lease an address in the 192.168.64/0/24 network. At this point, you can either choose to login or SSH to the VM. Unlike some other virtualization providers, you can SSH to the virtual machine from the host.
[source, bash]
----
ssh [email protected]

Choose a reason for hiding this comment

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

I haven't looked at the doc explaining how to geneate the ignition file, but does the ssh key need to be explicitly specified here?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

no it doesnt assuming you use a key in a place you know the system will look. in my case, i used an existing key in ~/.ssh

Copy link
Member

@dustymabe dustymabe left a comment

Choose a reason for hiding this comment

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

Looks good so far.

I think we need to add this to the index in modules/ROOT/nav.adoc

I know @ravanelli is going to test this out too and provide feedback.

--bootloader efi,variable-store=efi-variable-store,create \
--device virtio-blk,path=${IMAGE} \
--device virtio-net,nat \
--ignition ${IGNITION_CONFIG} \
Copy link
Member

Choose a reason for hiding this comment

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

interesting that vfkit supports an --ignition arg. neat.

--gui
----

Note: The AppleHV hypervisor does not allow you to see early boot and kernel messages. While you will see a grub boot menu, you will not see anything until later in the boot.
Copy link
Member

Choose a reason for hiding this comment

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

Suggestion -> GRUB

It's odd to me that a user can see GRUB but no kernel messages. That would indicate to me that it's not technically impossible, just that we haven't found the right settings?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

My understanding is that it is not exposed by Apple. Is this correct @cfergeau ?

Copy link
Member

Choose a reason for hiding this comment

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

but you would think if GRUB can output to a console (either VGA or serial) the kernel could too.. but I certainly don't know this platform at all and will trust the experts

Copy link
Contributor Author

Choose a reason for hiding this comment

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

the kernel messages are not there either @dustymabe even in the vga console

Copy link

Choose a reason for hiding this comment

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

I've filed crc-org/vfkit#270 to document this properly on vfkit's end, as the behaviour varies a lot depending on how you start the VM.

Now that vfkit makes it easy to inject ignition files while booting FCOS, we can add some simple documentation for provisioning.  This one is a hybrid between the hyperv and qemu provisioning documents.

Signed-off-by: Brent Baude <[email protected]>
@baude
Copy link
Contributor Author

baude commented Mar 6, 2025

ok, incorporated review comments thus far.

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.

3 participants