| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="cloud-create-cloud-profile">
|
|---|
| 4 | <title>Creating a Cloud Profile</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p><ph conkeyref="vbox-conkeyref-phrases/product-name"/> uses a <i>cloud profile</i> to connect to <ph
|
|---|
| 8 | conkeyref="vbox-conkeyref-phrases/oci"/>. A cloud profile is a text file that contains details of your key files
|
|---|
| 9 | and Oracle Cloud Identifier (OCID) resource identifiers for your cloud account, such as the following: </p>
|
|---|
| 10 | <ul>
|
|---|
| 11 | <li>
|
|---|
| 12 | <p><b outputclass="bold">Fingerprint of the public
|
|---|
| 13 | key.</b> To obtain the fingerprint, you can use the
|
|---|
| 14 | <userinput>openssl</userinput> command:
|
|---|
| 15 | </p>
|
|---|
| 16 | <pre xml:space="preserve">$ openssl rsa -pubout -outform DER -in ~/.oci/oci_api_key.pem | openssl md5 -c</pre>
|
|---|
| 17 | </li>
|
|---|
| 18 | <li>
|
|---|
| 19 | <p><b outputclass="bold">Location of the private key on the
|
|---|
| 20 | client device.</b> Specify the full path to the
|
|---|
| 21 | private key.
|
|---|
| 22 | </p>
|
|---|
| 23 | </li>
|
|---|
| 24 | <li>
|
|---|
| 25 | <p><b outputclass="bold">(Optional) Passphrase for the private
|
|---|
| 26 | key.</b> This is only required if the key is
|
|---|
| 27 | encrypted.
|
|---|
| 28 | </p>
|
|---|
| 29 | </li>
|
|---|
| 30 | <li>
|
|---|
| 31 | <p><b outputclass="bold">Region</b>. Shown on the <ph conkeyref="vbox-conkeyref-phrases/oci"/>
|
|---|
| 32 | Console. Click
|
|---|
| 33 | <b outputclass="bold">Administration</b>,
|
|---|
| 34 | <b outputclass="bold">Tenancy Details</b>.
|
|---|
| 35 | </p>
|
|---|
| 36 | </li>
|
|---|
| 37 | <li>
|
|---|
| 38 | <p><b outputclass="bold">Tenancy OCID.</b> Shown on the
|
|---|
| 39 | <ph conkeyref="vbox-conkeyref-phrases/oci"/> Console. Click
|
|---|
| 40 | <b outputclass="bold">Administration</b>,
|
|---|
| 41 | <b outputclass="bold">Tenancy Details</b>.
|
|---|
| 42 | </p>
|
|---|
| 43 | <p>
|
|---|
| 44 | A link enables you to copy the Tenancy OCID.
|
|---|
| 45 | </p>
|
|---|
| 46 | </li>
|
|---|
| 47 | <li>
|
|---|
| 48 | <p><b outputclass="bold">Compartment OCID.</b> Shown on
|
|---|
| 49 | the <ph conkeyref="vbox-conkeyref-phrases/oci"/> Console. Click
|
|---|
| 50 | <b outputclass="bold">Identity</b>,
|
|---|
| 51 | <b outputclass="bold">Compartments</b>.
|
|---|
| 52 | </p>
|
|---|
| 53 | <p>
|
|---|
| 54 | A link enables you to copy the Compartment OCID.
|
|---|
| 55 | </p>
|
|---|
| 56 | </li>
|
|---|
| 57 | <li>
|
|---|
| 58 | <p><b outputclass="bold">User OCID.</b> Shown on the
|
|---|
| 59 | <ph conkeyref="vbox-conkeyref-phrases/oci"/> Console. Click
|
|---|
| 60 | <b outputclass="bold">Profile</b>,
|
|---|
| 61 | <b outputclass="bold">User Settings</b>.
|
|---|
| 62 | </p>
|
|---|
| 63 | <p>
|
|---|
| 64 | A link enables you to copy the User OCID.
|
|---|
| 65 | </p>
|
|---|
| 66 | </li>
|
|---|
| 67 | </ul>
|
|---|
| 68 | <p>
|
|---|
| 69 | You can create a cloud profile in the following ways:
|
|---|
| 70 | </p>
|
|---|
| 71 | <ul>
|
|---|
| 72 | <li>
|
|---|
| 73 | <p>
|
|---|
| 74 | Automatically, by using the <b outputclass="bold">Cloud
|
|---|
| 75 | Profile Manager</b>. See
|
|---|
| 76 | <xref href="cloud-using-cloud-profile-manager.dita#cloud-using-cloud-profile-manager"/>.
|
|---|
| 77 | </p>
|
|---|
| 78 | <p>
|
|---|
| 79 | The Cloud Profile Manager is a <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> tool that enables
|
|---|
| 80 | you to create, edit, and manage cloud profiles for your
|
|---|
| 81 | cloud service accounts.
|
|---|
| 82 | </p>
|
|---|
| 83 | </li>
|
|---|
| 84 | <li>
|
|---|
| 85 | <p>
|
|---|
| 86 | Automatically, by using the <userinput>VBoxManage cloudprofile</userinput> command. See
|
|---|
| 87 | <xref href="vboxmanage-cloudprofile.dita"/>.
|
|---|
| 88 | </p>
|
|---|
| 89 | </li>
|
|---|
| 90 | <li>
|
|---|
| 91 | <p>
|
|---|
| 92 | Manually, by creating an <filepath>oci_config</filepath>
|
|---|
| 93 | file in your <ph conkeyref="vbox-conkeyref-phrases/product-name"/> global configuration directory.
|
|---|
| 94 | For example, this is
|
|---|
| 95 | <filepath>$HOME/.config/VirtualBox/oci_config</filepath> on
|
|---|
| 96 | a Linux host.
|
|---|
| 97 | </p>
|
|---|
| 98 | </li>
|
|---|
| 99 | <li>
|
|---|
| 100 | <p>
|
|---|
| 101 | Manually, by creating a <filepath>config</filepath> file in
|
|---|
| 102 | your <ph conkeyref="vbox-conkeyref-phrases/oci"/> configuration directory. For example, this is
|
|---|
| 103 | <filepath>$HOME/.oci/config</filepath> on a Linux host.
|
|---|
| 104 | </p>
|
|---|
| 105 | <p>
|
|---|
| 106 | This is the same file that is used by the <ph conkeyref="vbox-conkeyref-phrases/oci"/> command line
|
|---|
| 107 | interface.
|
|---|
| 108 | </p>
|
|---|
| 109 | <p>
|
|---|
| 110 | <ph conkeyref="vbox-conkeyref-phrases/product-name"/> automatically uses the
|
|---|
| 111 | <filepath>config</filepath> file if no cloud profile file is
|
|---|
| 112 | present in your global configuration directory.
|
|---|
| 113 | Alternatively, you can import this file manually into the
|
|---|
| 114 | Cloud Profile Manager.
|
|---|
| 115 | </p>
|
|---|
| 116 | </li>
|
|---|
| 117 | </ul>
|
|---|
| 118 | </body>
|
|---|
| 119 |
|
|---|
| 120 | </topic>
|
|---|
