jprdonnelly/docs
1
0
Fork 0
mirror of synced 2025-12-23 21:07:12 -05:00
Code Issues Projects Releases Wiki Activity

Codespace prebuild support for monorepos and external repo access (#29232)

Browse Source 
* Make changes for multiple config files

* Clarify deprecated procedure

* Optimize images

* More WiP changes

* More WiP changes

* Update s/shots - no longer beta

* Optimize images

* More WiP changes

* Fix broken links

* WiP

* Add authorizations screenshots

* Optimize images

* Reorg requested by reviewer

* Update content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md

* Update content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md

* Update content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md

* Update content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md

Co-authored-by: Felicity Chapman <felicitymay@github.com>

* Update content/codespaces/prebuilding-your-codespaces/configuring-prebuilds.md

* Update content/codespaces/troubleshooting/troubleshooting-prebuilds.md

Co-authored-by: Felicity Chapman <felicitymay@github.com>

* Update data/reusables/codespaces/billing-for-prebuilds.md

* Tiny tweak to creation article

* Another tiny tweak to creation article

* Fix self-referential link

Co-authored-by: github-actions <github-actions@github.com>
Co-authored-by: Felicity Chapman <felicitymay@github.com>
This commit is contained in:
hubwriter
2022-07-28 17:16:42 +01:00
committed by GitHub
parent 517a72b5c2
commit 238d02f82c
22 changed files with 127 additions and 77 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
content/codespaces/troubleshooting/troubleshooting-prebuilds.md
View File

@@ -55,8 +55,14 @@ Here are things to check if the "{% octicon "zap" aria-label="The zap icon" %} P
* Check whether a change to the dev container configuration was pushed to the prebuild-enabled branch recently. If so, you will typically have to wait until the prebuild workflow run for this push completes before prebuilds are available again.
* If no configuration changes were recently made, go to the **Actions** tab of your repository, click **{% octicon "codespaces" aria-label="The Codespaces icon" %} {% data variables.product.prodname_codespaces %} Prebuilds** in the workflows list, and check that prebuild workflow runs for the branch are succeeding. If latest runs of a workflow failed, and one or more of these failed runs contained changes to the dev container configuration, then there will be no available prebuilds for the associated branch.
## Some resources cannot be accessed in codespaces created using a prebuild
If the `devcontainer.json` configuration file for a prebuild configuration specifies that permissions for access to other repositories are required, then the repository administrator is prompted to authorize these permissions when they create or update the prebuild configuration. If the administrator does not grant all of the requested permissions there's a chance that problems may occur in the prebuild, and in codespaces created from this prebuild. This is true even if the user who creates a codespace based on this prebuild _does_ grant all of the permissions when they are prompted to do so.
## Troubleshooting failed workflow runs for prebuilds
If the `devcontainer.json` configuration file for a prebuild configuration is updated to specify that permissions for access to other repositories are required, and a repository administrator has not been prompted to authorize these permissions for the prebuild configuration, then the prebuild workflow may fail. Try updating the prebuild configuration, without making any changes. If, when you click **Update**, the authorization page is displayed, check that the requested permissions are appropriate and, if so, authorize the request. For more information, see "[Managing prebuilds](/codespaces/prebuilding-your-codespaces/managing-prebuilds#editing-a-prebuild-configuration)" and "[Managing access to other repositories within your codespace](/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces#setting-additional-repository-permissions)."
If the workflow runs for a prebuild configuration are failing, you can temporarily disable the prebuild configuration while you investigate. For more information, see "[Managing prebuilds](/codespaces/prebuilding-your-codespaces/managing-prebuilds#disabling-a-prebuild-configuration)."
## Further reading