From 92c59a063295c03fc59f464a2e73e548aa5fb953 Mon Sep 17 00:00:00 2001
From: Stephen Brennan
Date: Wed, 15 May 2024 15:10:02 -0700
Subject: [PATCH] Automatic documentation update
---
_sources/changelog.md.txt | 3 +++
_sources/guide/region.md.txt | 3 ++-
_sources/install.rst.txt | 15 +++++++++++++++
changelog.html | 2 ++
guide/region.html | 3 ++-
install.html | 15 +++++++++++++++
searchindex.js | 2 +-
7 files changed, 40 insertions(+), 3 deletions(-)
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 @@ Unreleased
diff --git a/guide/region.html b/guide/region.html
index 3c47a5b..da430dd 100644
--- a/guide/region.html
+++ b/guide/region.html
@@ -76,7 +76,8 @@ Using multiple regions