diff --git a/_sources/changelog.md.txt b/_sources/changelog.md.txt index 0528813..bdc2a79 100644 --- a/_sources/changelog.md.txt +++ b/_sources/changelog.md.txt @@ -14,6 +14,9 @@ should appear here. command line. - Please see the documentation for a migration guide: https://oracle.github.io/yo/guide/region.html#migrating-yo-ini-to-multi-region-support +- Switched Yo's default setup dialog to use ``oci setup keys``. Updated + documentation accordingly. + ## 1.6.0 - Wed, Apr 17, 2024 diff --git a/_sources/guide/region.md.txt b/_sources/guide/region.md.txt index c3c64db..9c02a6a 100644 --- a/_sources/guide/region.md.txt +++ b/_sources/guide/region.md.txt @@ -47,7 +47,8 @@ environment variable may be overridden by the command line option. ## Migrating yo.ini to multi-region support -Upon upgrading Yo, you may see the following warning: +Upon upgrading Yo to version 1.7.0 or later from any prior version, you may see +the following warning: ``` warning: region-specific configurations in [yo] section are deprecated, please update your config to use [regions.*] sections diff --git a/_sources/install.rst.txt b/_sources/install.rst.txt index 9cedf67..6d4412f 100644 --- a/_sources/install.rst.txt +++ b/_sources/install.rst.txt @@ -50,6 +50,21 @@ but thankfully, this can be easily achieved with the command: Follow the prompts to authenticate with your tenancy. If you don't know your region, open the OCI Web UI and see what it defaults to. +Please note: if you encounter an error message in the above command which +contains the code ``NotAuthorizedOrNotFound``, then there's an alternative way +to setup your OCI credentials: + +1. Run ``oci setup keys``. At the prompt, you probably want to type "N/A" to + avoid setting a passphrase for the key. +2. Open the OCI web console. Navigate to your profile using the icon at the top + right (or search your email address in the search bar). On your profile page, + select the "API keys" link, and then choose "Add API key". +3. Use "choose public key file" to upload the **public key** generated by step + 1, and click submit. The resulting page should contain a fragment of + configuration file. +4. Paste the configuration fragment into ``~/.oci/config``. Be sure to set + ``key_file`` to the name of your **private** key. + yo Configuration ~~~~~~~~~~~~~~~~ diff --git a/changelog.html b/changelog.html index 29f29b4..5ea9044 100644 --- a/changelog.html +++ b/changelog.html @@ -50,6 +50,8 @@
Upon upgrading Yo, you may see the following warning:
+Upon upgrading Yo to version 1.7.0 or later from any prior version, you may see +the following warning:
warning: region-specific configurations in [yo] section are deprecated, please update your config to use [regions.*] sections
Run oci setup keys
. At the prompt, you probably want to type “N/A” to
+avoid setting a passphrase for the key.
Open the OCI web console. Navigate to your profile using the icon at the top +right (or search your email address in the search bar). On your profile page, +select the “API keys” link, and then choose “Add API key”.
Use “choose public key file” to upload the public key generated by step +1, and click submit. The resulting page should contain a fragment of +configuration file.
Paste the configuration fragment into ~/.oci/config
. Be sure to set
+key_file
to the name of your private key.