Clarify how to customize launch options when importing a custom image
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 669
- Forks
- 236
- Avg merge
- 1m
- Merged PRs (30d)
- 4
Description
Hi.
It is not clear how to provide launch options (e.g. specify firmware type) when importing a custom image from block storage with oci compute image import.
The manpage of that command contains the following information:
--launch-mode [text]
Specifies the configuration mode for launching virtual machine (VM)
instances. The configuration modes are: * NATIVE - VM instances launch
with paravirtualized boot and VFIO devices. The default value for
platform images. * EMULATED - VM instances launch with emulated
devices, such as the E1000 network driver and emulated SCSI disk
controller. * PARAVIRTUALIZED - VM instances launch with
paravirtualized devices using VirtIO drivers. * CUSTOM - VM instances
launch with custom configuration settings specified in the
LaunchOptions parameter.
Is it possible to provide a LaunchOptions parameter using oci-cli? If so, would it be possible to add some more clarifications to the manpage on how to achieve it?
Many thanks.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Review the oci compute image import command and its manpage, starting with the existing --launch-mode documentation and the reference to LaunchOptions. Clarify whether and how a LaunchOptions parameter can be supplied through the CLI, then update the manpage with an example or precise usage guidance and verify that the resulting documentation answers the import workflow.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- cli, cloud, documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 72/100