Skip to content

Commit 00a066d

Browse files
committed
update for UI changes
1 parent 1e6d49a commit 00a066d

9 files changed

+13
-13
lines changed
Binary file not shown.
79.8 KB
Loading
74 KB
Loading
50.6 KB
Loading
54.4 KB
Loading
61 KB
Loading

content/codespaces/prebuilding-your-codespaces/about-codespaces-prebuilds.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Prebuilding your codespaces allows you to be more productive and access your cod
1616

1717
By default, whenever you push changes to your repository, {% data variables.product.prodname_codespaces %} uses {% data variables.product.prodname_actions %} to automatically update your prebuilds.
1818

19-
When prebuilds are available for a particular branch of a repository, and for your region, you'll see the "{% octicon "zap" aria-label="The zap icon" %} Prebuild ready" label in the list of machine type options when you create a codespace. For more information, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)."
19+
When prebuilds are available for a particular branch of a repository, and for your region, you'll see the "{% octicon "zap" aria-label="The zap icon" %} Prebuild ready" label in the list of machine type options when you create a codespace. If a prebuild is still being created, you will see the "{% octicon "history" aria-label="The history icon" %} Prebuild in progress" label. For more information, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)."
2020

2121
![The dialog box for choosing a machine type](/assets/images/help/codespaces/choose-custom-machine-type.png)
2222

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

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Before you can configure prebuilds for your project the following must be true:
3636

3737
![The 'Set up prebuilds' button](/assets/images/help/codespaces/prebuilds-set-up.png)
3838

39-
1. Choose the branch for which you want to set up a prebuild.
39+
1. Choose the branch for which you want to set up a prebuild.
4040

4141
![The Branch drop-down menu](/assets/images/help/codespaces/prebuilds-choose-branch.png)
4242

@@ -46,7 +46,15 @@ Before you can configure prebuilds for your project the following must be true:
4646

4747
{% endnote %}
4848

49-
1. Choose the regions in which you want to set up a prebuild. Developers must be located in a region you select to be able to create codespaces from a prebuild. Alternatively, select **All regions**.
49+
1. Choose how you want to automatically trigger updates of the prebuild template.
50+
51+
* **Every push** (the default setting) - With this setting, prebuild configurations will be updated on every push made to the given branch. This will ensure that codespaces generated from a prebuild template always contain the latest codespace configuration, including any recently added or updated dependencies.
52+
* **On configuration change** - With this setting, prebuild configurations will be updated every time associated configuration files for a given repo and branch are updated. This ensures that changes to the dev container configuration files for the repository are used when a codespace is generated from a prebuild template. The Actions workflow that updates the prebuild template will run less often, so this option will use fewer Actions minutes. However, this option will not guarantee that codespaces always include recently added or updated dependencies, so these may have to be added or updated manually after a codespace has been created.
53+
* **Scheduled** - With this setting, you can have your prebuild configurations update on a custom schedule that's defined by you. This can reduce consumption of Actions minutes, and reduce the amount of time during which prebuilds are unavailable because they are being updated. However, with this option, codespaces may be created that do not use the latest dev container configuration changes.
54+
55+
![The prebuild trigger options](/assets/images/help/codespaces/prebuilds-triggers.png)
56+
57+
1. Select **Reduce prebuild available to only specific regions** if you only want your prebuilt image available to certain regions, then select which regions you want it available in. Developers must be located in a region you select to be able to create codespaces from a prebuild. By default, your prebuilt image is available to all regions where codespaces is available and storage costs apply for each region.
5058

5159
![The region selection options](/assets/images/help/codespaces/prebuilds-regions.png)
5260

@@ -58,25 +66,17 @@ Before you can configure prebuilds for your project the following must be true:
5866

5967
{% endnote %}
6068

61-
1. Choose how you want to automatically trigger updates of the prebuild template.
62-
63-
* **Every push** (the default setting) - With this setting, prebuild configurations will be updated on every push made to the given branch. This will ensure that codespaces generated from a prebuild template always contain the latest codespace configuration, including any recently added or updated dependencies.
64-
* **On configuration change** - With this setting, prebuild configurations will be updated every time associated configuration files for a given repo and branch are updated. This ensures that changes to the dev container configuration files for the repository are used when a codespace is generated from a prebuild template. The Actions workflow that updates the prebuild template will run less often, so this option will use fewer Actions minutes. However, this option will not guarantee that codespaces always include recently added or updated dependencies, so these may have to be added or updated manually after a codespace has been created.
65-
* **Scheduled** - With this setting, you can have your prebuild configurations update on a custom schedule that's defined by you. This can reduce consumption of Actions minutes, and reduce the amount of time during which prebuilds are unavailable because they are being updated. However, with this option, codespaces may be created that do not use the latest dev container configuration changes.
66-
67-
![The prebuild trigger options](/assets/images/help/codespaces/prebuilds-triggers.png)
68-
6969
1. Set the number of prebuild template versions to be retained. You can input any number between 1 and 5. The default number of saved versions is 2, which means that only the latest template version and the previous version are saved.
7070

7171
Depending on your prebuild trigger settings, your prebuild template could change with each push or on each dev container configuration change. Retaining older versions of prebuild templates enables you to create a prebuild from an older commit with a different dev container configuration than the current prebuild template. Since there is a storage cost associated with retaining prebuild template versions, you can choose the number of versions to be retained based on the needs of your team. For more information on billing, see "[About billing for {% data variables.product.prodname_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-codespaces#codespaces-pricing)."
7272

7373
If you set the number of prebuild template versions to save to 1, {% data variables.product.prodname_codespaces %} will only save the latest version of the prebuild template and will delete the older version each time the template is updated. This means you will not get a prebuilt codespace if you back to any older dev container configuration.
7474

75-
![The prebuild template history setting](/assets/images/help/codespaces/codespaces-prebuilds-template-history-setting.png)
75+
![The prebuild template history setting](/assets/images/help/codespaces/prebuilds-template-history-setting.png)
7676

7777
1. Add users or teams to notify when your prebuild workflow runs fail for this particular prebuild configuration. You can begin typing a username, team name, or full name, then click the name once it appears to add them to the list. The users or teams you add will receive an email when prebuild failures occur, containing a link to the workflow run logs to help with further investigation.
7878

79-
![The prebuild failure notification setting](/assets/images/help/codespaces/codespaces-prebuilds-failure-notification-setting.png)
79+
![The prebuild failure notification setting](/assets/images/help/codespaces/prebuilds-failure-notification-setting.png)
8080

8181
1. Click **Create**.
8282

0 commit comments

Comments
 (0)