oracle / oracle/oci-cli

Clarify how to customize launch options when importing a custom image

Open Beginner friendly
#416 4 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Compute
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.