PMM-12293 doc update (#1114)

* PMM-12293 doc update

* Update docs/release-notes/2.38.1.md

Co-authored-by: Roman Novikov <[email protected]>

* feedback from Roma

* Update variables.yml

* ToC update

* added infoi about 3rdparty providers

* typo

* reworded issue

* Update 2.38.1.md

* implemented feedback from Roma

* updated release date

---------

Co-authored-by: Roman Novikov <[email protected]>

docs/release-notes/2.38.1.md

@@ -0,0 +1,17 @@
+# Percona Monitoring and Management 2.38.1
+
+| **Release date:** | July 13, 2023                                                                                    |
+| ----------------- | ----------------------------------------------------------------------------------------------- |
+| **Installation:** | [Installing Percona Monitoring and Management](https://www.percona.com/software/pmm/quickstart) |
+
+Percona Monitoring and Management (PMM) is an open-source database monitoring, management, and observability solution for MySQL, PostgreSQL, and MongoDB.
+
+## Fixed issue
+
+[PMM-12293](https://jira.percona.com/browse/PMM-12293) - The upgrade to Grafana  9.2.20 in PMM 2.38 fixed critical security [CVE-2023-3128](https://grafana.com/blog/2023/06/22/grafana-security-release-for-cve-2023-3128/) by changing the authentication mechanism to rely solely on the user's unique ID provided by the identity provider.
+
+This change caused an authentication issue for second and subsequent connections to PMM using a Percona Account. With this PMM update, we are fixing this authentication issue to ensure that users can log back into PMM after an initial connection. Previously, this would fail with a "User already exists" error.
+
+If you are using a third-party authentication provider and continue to see this issue, pass the **GF_AUTH_OAUTH_ALLOW_INSECURE_EMAIL_LOOKUP=1** environment variable to the PMM container.
+
+Alternatively, set the **oauth_allow_insecure_email_lookup** config key in the **auth** section of the `grafana.ini` file. Keep in mind that any changes you make to this file are lost when upgrading PMM, so make sure to manually update this file after each upgrade.

mkdocs-base.yml

@@ -317,6 +317,7 @@ nav:
   - faq.md
   - Release Notes:
       - release-notes/index.md
+      - "PMM 2.38.1": release-notes/2.38.1.md
       - "PMM 2.38.0": release-notes/2.38.0.md
       - "PMM 2.37.1": release-notes/2.37.1.md
       - "PMM 2.37.0": release-notes/2.37.0.md

variables.yml

@@ -1,10 +1,9 @@
 # PMM Version for HTML
 # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path
 
-release: '2.38.0'
-version: '2.38'
-release_date: 2023-07-3
-
+release: '2.38.1'
+version: '2.38.1'
+release_date: 2023-07-13
 # SVG icons. Use in markdown as {{icon.<name>}}
 # For the Percona image icon (encoded inline SVG), see https://css-tricks.com/using-svg/
 icon: