Merge pull request github#28742 from github/repo-sync

docs-bot · web-flow · commit 5bbaf86006b3 · 2023-10-02T05:36:33.000-07:00
Repo sync
diff --git a/data/release-notes/enterprise-server/3-7/0.yml b/data/release-notes/enterprise-server/3-7/0.yml
@@ -375,6 +375,14 @@ sections:
     - |
       Package registries on the new GitHub Packages architecture, including Container registry and npm packages, no longer expose data through the GraphQL API. In a coming release, other GitHub Packages registries will migrate to the new architecture, which will deprecate the GraphQL API for those registries as well.
 
+    # https://github.com/github/releases/issues/1569
+    - |
+      In GitHub Enterprise Server 3.6 and later, GitHub is changing the supported algorithms and hash functions for Git operations over SSH. By default, SSH connections that satisfy **both** of the following conditions will fail.
+
+      {% data reusables.ssh.rsa-sha-1-connection-failure-criteria %}
+
+      You can adjust the cutoff date. For more information, see "[Configuring SSH connections to your instance](/admin/configuration/configuring-your-enterprise/configuring-ssh-connections-to-your-instance)." [Updated: 2023-09-29]
+
   errata:
     - '{% data reusables.release-notes.github-actions-secrets-encryption-docs %}'
 
diff --git a/data/release-notes/enterprise-server/3-9/0-rc1.yml b/data/release-notes/enterprise-server/3-9/0-rc1.yml
@@ -411,6 +411,8 @@ sections:
       During the validation phase of a configuration run, a `No such object` error may occur for the Notebook and Viewscreen services. This error can be ignored as the services should still correctly start.
     - |
       If the root site administrator is locked out of the Management Console after failed login attempts, the account will not unlock automatically after the defined lockout time. Someone with administrative SSH access to the instance must unlock the account using the administrative shell. For more information, see "[AUTOTITLE](/admin/configuration/administering-your-instance-from-the-management-console/troubleshooting-access-to-the-management-console#unlocking-the-root-site-administrator-account)."
+    - |
+      {% data reusables.release-notes.2023-09-ephemeral-self-hosted-runners-not-auto-upgrading %} [Updated: 2023-09-29]
 
   deprecations:
     # https://github.com/github/releases/issues/2826
diff --git a/data/release-notes/enterprise-server/3-9/0.yml b/data/release-notes/enterprise-server/3-9/0.yml
@@ -430,6 +430,8 @@ sections:
 
     - |
       {% data reusables.release-notes.2023-09-config-apply-timeout-hookshot-go-replicas %} [Updated: 2023-09-21]
+    - |
+      {% data reusables.release-notes.2023-09-ephemeral-self-hosted-runners-not-auto-upgrading %} [Updated: 2023-09-29]
 
   deprecations:
     # https://github.com/github/releases/issues/2826
diff --git a/data/release-notes/enterprise-server/3-9/1.yml b/data/release-notes/enterprise-server/3-9/1.yml
@@ -150,3 +150,5 @@ sections:
       [Updated: 2023-09-05]
     - |
       {% data reusables.release-notes.2023-09-config-apply-timeout-hookshot-go-replicas %} [Updated: 2023-09-21]
+    - |
+      {% data reusables.release-notes.2023-09-ephemeral-self-hosted-runners-not-auto-upgrading %} [Updated: 2023-09-29]
diff --git a/data/release-notes/enterprise-server/3-9/2.yml b/data/release-notes/enterprise-server/3-9/2.yml
@@ -65,3 +65,5 @@ sections:
       [Updated: 2023-09-05]
     - |
       {% data reusables.release-notes.2023-09-config-apply-timeout-hookshot-go-replicas %} [Updated: 2023-09-21]
+    - |
+      {% data reusables.release-notes.2023-09-ephemeral-self-hosted-runners-not-auto-upgrading %} [Updated: 2023-09-29]
diff --git a/data/release-notes/enterprise-server/3-9/3.yml b/data/release-notes/enterprise-server/3-9/3.yml
@@ -59,3 +59,6 @@ sections:
       {% data reusables.release-notes.2023-08-mssql-replication-known-issue %} [Updated: 2023-08-24]
     - |
       {% data reusables.release-notes.2023-09-config-apply-timeout-hookshot-go-replicas %} [Updated: 2023-09-21]
+    - |
+      {% data reusables.release-notes.2023-09-ephemeral-self-hosted-runners-not-auto-upgrading %} [Updated: 2023-09-29]
+    
diff --git a/data/release-notes/enterprise-server/3-9/4.yml b/data/release-notes/enterprise-server/3-9/4.yml
@@ -49,3 +49,5 @@ sections:
       {% data reusables.release-notes.2023-08-mssql-replication-known-issue %} [Updated: 2023-09-04]
     - |
       {% data reusables.release-notes.2023-09-config-apply-timeout-hookshot-go-replicas %} [Updated: 2023-09-21]
+    - |
+      {% data reusables.release-notes.2023-09-ephemeral-self-hosted-runners-not-auto-upgrading %} [Updated: 2023-09-29]
diff --git a/data/release-notes/enterprise-server/3-9/5.yml b/data/release-notes/enterprise-server/3-9/5.yml
@@ -23,8 +23,8 @@ sections:
     - On an instance with subdomain isolation disabled, a notebook could not be loaded due to incorrect asset paths.
     - On an instance with subdomain isolation disabled, a notebook could not be loaded due to an extra `/` character in the URL path.
     - On an instance with a GitHub Advanced Security license and secret scanning enabled, in some cases, custom patterns would erroneously show no results for a dry run.
+    - On an instance with GitHub Actions enabled, the software on ephemeral runners would not automatically update to the latest version.
   changes:
-    - On an instance with GitHub Actions enabled, the software on ephemeral runners is updated automatically.
     - When listing the node metadata for all nodes using the [Manage GitHub Enterprise Server REST API](https://docs.github.com/enterprise-server/rest/enterprise-admin/manage-ghes?apiVersion=2022-11-28#get-all-ghes-node-metadata-for-all-nodes), information about whether a given node is a replica is included.
     - When GitHub Enterprise checks for a new upgrade or hotpatch package, if the check fails the failure details are output to the `ghe-update-check` log, and the Management Console UI provides a "Check Again" button to rerun the check.
     - When providing data to GitHub Support, GitHub Enterprise Server displays a notice describing how support data is used before uploading the support files.
diff --git a/data/reusables/release-notes/2023-09-ephemeral-self-hosted-runners-not-auto-upgrading.md b/data/reusables/release-notes/2023-09-ephemeral-self-hosted-runners-not-auto-upgrading.md
@@ -0,0 +1 @@
+On an instance with GitHub Actions enabled, ephemeral self-hosted runners do not automatically update to the latest version. Users will need to manually update the runners to the latest version.
diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json
@@ -3435,6 +3435,15 @@
         "additional-permissions": [],
         "access": "write"
       },
+      {
+        "category": "codespaces",
+        "slug": "check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user",
+        "subcategory": "codespaces",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/codespaces/permissions_check",
+        "additional-permissions": [],
+        "access": "write"
+      },
       {
         "category": "codespaces",
         "slug": "create-a-codespace-from-a-pull-request",
diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json
@@ -1452,6 +1452,12 @@
       "verb": "get",
       "requestPath": "/repos/{owner}/{repo}/codespaces/new"
     },
+    {
+      "slug": "check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user",
+      "subcategory": "codespaces",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/codespaces/permissions_check"
+    },
     {
       "slug": "list-repository-secrets",
       "subcategory": "repository-secrets",
diff --git a/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json b/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json
@@ -4247,6 +4247,17 @@
         "server-to-server": false,
         "additional-permissions": []
       },
+      {
+        "category": "codespaces",
+        "slug": "check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user",
+        "subcategory": "codespaces",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/codespaces/permissions_check",
+        "access": "write",
+        "user-to-server": true,
+        "server-to-server": false,
+        "additional-permissions": []
+      },
       {
         "category": "codespaces",
         "slug": "create-a-codespace-from-a-pull-request",
diff --git a/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json b/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json
@@ -1470,6 +1470,12 @@
       "verb": "get",
       "requestPath": "/repos/{owner}/{repo}/codespaces/new"
     },
+    {
+      "slug": "check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user",
+      "subcategory": "codespaces",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/codespaces/permissions_check"
+    },
     {
       "slug": "list-repository-secrets",
       "subcategory": "repository-secrets",
diff --git a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json
@@ -4093,6 +4093,15 @@
         "additional-permissions": [],
         "access": "write"
       },
+      {
+        "category": "codespaces",
+        "slug": "check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user",
+        "subcategory": "codespaces",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/codespaces/permissions_check",
+        "additional-permissions": [],
+        "access": "write"
+      },
       {
         "category": "codespaces",
         "slug": "create-a-codespace-from-a-pull-request",
diff --git a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json
@@ -1568,6 +1568,12 @@
       "verb": "get",
       "requestPath": "/repos/{owner}/{repo}/codespaces/new"
     },
+    {
+      "slug": "check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user",
+      "subcategory": "codespaces",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/codespaces/permissions_check"
+    },
     {
       "slug": "list-repository-secrets",
       "subcategory": "repository-secrets",
diff --git a/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json b/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json
@@ -5041,6 +5041,17 @@
         "server-to-server": false,
         "additional-permissions": []
       },
+      {
+        "category": "codespaces",
+        "slug": "check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user",
+        "subcategory": "codespaces",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/codespaces/permissions_check",
+        "access": "write",
+        "user-to-server": true,
+        "server-to-server": false,
+        "additional-permissions": []
+      },
       {
         "category": "codespaces",
         "slug": "create-a-codespace-from-a-pull-request",
diff --git a/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json b/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json
@@ -1586,6 +1586,12 @@
       "verb": "get",
       "requestPath": "/repos/{owner}/{repo}/codespaces/new"
     },
+    {
+      "slug": "check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user",
+      "subcategory": "codespaces",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/codespaces/permissions_check"
+    },
     {
       "slug": "list-repository-secrets",
       "subcategory": "repository-secrets",
diff --git a/src/github-apps/lib/config.json b/src/github-apps/lib/config.json
@@ -60,5 +60,5 @@
       "2022-11-28"
     ]
   },
-  "sha": "ffaf232180dbaff57ce08fa5490df44bbc606501"
+  "sha": "2b0299e5e69c42a2e28b40344541fe085a1ca617"
 }
diff --git a/src/rest/data/fpt-2022-11-28/schema.json b/src/rest/data/fpt-2022-11-28/schema.json
@@ -160697,6 +160697,126 @@
           }
         ]
       },
+      {
+        "serverUrl": "https://api.github.com",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/codespaces/permissions_check",
+        "title": "Check if permissions defined by a devcontainer have been accepted by the authenticated user",
+        "category": "codespaces",
+        "subcategory": "codespaces",
+        "parameters": [
+          {
+            "name": "owner",
+            "description": "<p>The account owner of the repository. The name is not case sensitive.</p>",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "repo",
+            "description": "<p>The name of the repository without the <code>.git</code> extension. The name is not case sensitive.</p>",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "ref",
+            "description": "<p>The git reference that points to the location of the devcontainer configuration to use for the permission check. The value of <code>ref</code> will typically be a branch name (<code>heads/BRANCH_NAME</code>). For more information, see \"<a href=\"https://git-scm.com/book/en/v2/Git-Internals-Git-References\">Git References</a>\" in the Git documentation.</p>",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "examples": [
+                "master"
+              ]
+            }
+          },
+          {
+            "name": "devcontainer_path",
+            "description": "<p>Path to the devcontainer.json configuration to use for the permission check.</p>",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "examples": [
+                ".devcontainer/example/devcontainer.json"
+              ]
+            }
+          }
+        ],
+        "bodyParameters": [],
+        "enabledForGitHubApps": true,
+        "codeExamples": [
+          {
+            "key": "default",
+            "request": {
+              "description": "Example",
+              "acceptHeader": "application/vnd.github.v3+json",
+              "parameters": {
+                "owner": "OWNER",
+                "repo": "REPO"
+              }
+            },
+            "response": {
+              "statusCode": "200",
+              "contentType": "application/json",
+              "description": "<p>Response when the permission check is successful</p>",
+              "example": {
+                "accepted": true
+              },
+              "schema": {
+                "title": "Codespaces Permissions Check",
+                "description": "Permission check result for a given devcontainer config.",
+                "type": "object",
+                "properties": {
+                  "accepted": {
+                    "description": "Whether the user has accepted the permissions defined by the devcontainer config",
+                    "type": "boolean",
+                    "examples": [
+                      true
+                    ]
+                  }
+                },
+                "required": [
+                  "accepted"
+                ]
+              }
+            }
+          }
+        ],
+        "previews": [],
+        "descriptionHTML": "<p>Checks whether the permissions defined by a given devcontainer configuration have been accepted by the authenticated user.</p>\n<p>You must authenticate using an access token with the <code>codespace</code> scope to use this endpoint.</p>\n<p>GitHub Apps must have write access to the <code>codespaces</code> repository permission to use this endpoint.</p>",
+        "statusCodes": [
+          {
+            "httpStatusCode": "200",
+            "description": "<p>Response when the permission check is successful</p>"
+          },
+          {
+            "httpStatusCode": "401",
+            "description": "<p>Requires authentication</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          },
+          {
+            "httpStatusCode": "404",
+            "description": "<p>Resource not found</p>"
+          },
+          {
+            "httpStatusCode": "422",
+            "description": "<p>Validation failed, or the endpoint has been spammed.</p>"
+          },
+          {
+            "httpStatusCode": "503",
+            "description": "<p>Service unavailable</p>"
+          }
+        ]
+      },
       {
         "serverUrl": "https://api.github.com",
         "verb": "post",
diff --git a/src/rest/data/ghec-2022-11-28/schema.json b/src/rest/data/ghec-2022-11-28/schema.json
diff --git a/src/rest/data/ghes-3.10-2022-11-28/schema.json b/src/rest/data/ghes-3.10-2022-11-28/schema.json
diff --git a/src/rest/data/ghes-3.8/schema.json b/src/rest/data/ghes-3.8/schema.json
diff --git a/src/rest/data/ghes-3.9-2022-11-28/schema.json b/src/rest/data/ghes-3.9-2022-11-28/schema.json
diff --git a/src/rest/lib/config.json b/src/rest/lib/config.json
diff --git a/src/webhooks/lib/config.json b/src/webhooks/lib/config.json

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+On an instance with GitHub Actions enabled, ephemeral self-hosted runners do not automatically update to the latest version. Users will need to manually update the runners to the latest version.`