Skip to content

Commit df0dae4

Browse files
[Improvement]: Update "Setting up a staging instance" for GitHub Packages (#57526)
Co-authored-by: Felicity Chapman <felicitymay@github.com>
1 parent 68358bb commit df0dae4

File tree

1 file changed

+15
-32
lines changed

1 file changed

+15
-32
lines changed

content/admin/installing-your-enterprise-server/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance.md

Lines changed: 15 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ If you want to test changes on an instance that contains the same data and confi
5757
5858
### 2. Set up a staging instance
5959

60-
Set up a new instance to act as your staging environment. When following the setup process, be sure to select the **"New Install"** option. This will ensure your staging environment is initialized properly and is ready for restoring a backup if needed.
60+
Set up a new instance to act as your staging environment. When following the setup process, be sure to select the **New Install** option. This will ensure your staging environment is initialized properly and is ready for restoring a backup if needed.
6161

6262
You can use the same guides for provisioning and installing your staging instance as you did for your production instance. For more information, see [AUTOTITLE](/admin/installation/setting-up-a-github-enterprise-server-instance).
6363

@@ -89,39 +89,22 @@ Once you've configured and enabled {% data variables.product.prodname_actions %}
8989

9090
### 4. Configure {% data variables.product.prodname_registry %}
9191

92-
Optionally, if you use {% data variables.product.prodname_registry %} on your production instance, configure the feature on the staging instance before restoring your production backup. If you don't use {% data variables.product.prodname_registry %}, skip to [1. Restore your production backup](#5-restore-your-production-backup).
92+
Optionally, if you use {% data variables.product.prodname_registry %} on your production instance, configure the feature on the staging instance before restoring your production backup. If you don't use {% data variables.product.prodname_registry %}, skip to [Restore your production backup](#5-restore-your-production-backup).
9393

9494
> [!WARNING]
95-
> If you don't configure {% data variables.product.prodname_registry %} on the staging instance before restoring your production backup, your staging instance will use your production instance's external storage, which could result in loss of data. We strongly recommended that you use different external storage for your staging instance.
96-
97-
1. Review the backup you will restore to the staging instance.
98-
* If you took the backup with {% data variables.product.prodname_enterprise_backup_utilities %} 3.5 or later, the backup includes the configuration for {% data variables.product.prodname_registry %}. Continue to the next step.
99-
* If you took the backup with {% data variables.product.prodname_enterprise_backup_utilities %} 3.4 or earlier, configure {% data variables.product.prodname_registry %} on the staging instance. For more information, see [AUTOTITLE](/admin/packages/getting-started-with-github-packages-for-your-enterprise).
100-
{% data reusables.enterprise_installation.ssh-into-staging-instance %}
101-
1. Configure the external storage connection by entering the following commands, replacing the placeholder values with actual values for your connection.
102-
* Azure Blob Storage:
103-
104-
```shell copy
105-
ghe-config secrets.packages.blob-storage-type "azure"
106-
ghe-config secrets.packages.azure-container-name "AZURE CONTAINER NAME"
107-
ghe-config secrets.packages.azure-connection-string "CONNECTION STRING"
108-
```
109-
110-
* Amazon S3:
111-
112-
```shell copy
113-
ghe-config secrets.packages.blob-storage-type "s3"
114-
ghe-config secrets.packages.service-url "S3 SERVICE URL"
115-
ghe-config secrets.packages.s3-bucket "S3 BUCKET NAME"
116-
ghe-config secrets.packages.aws-access-key "S3 ACCESS KEY ID"
117-
ghe-config secrets.packages.aws-secret-key "S3 ACCESS SECRET"
118-
```
119-
120-
1. To prepare to enable {% data variables.product.prodname_registry %} on the staging instance, enter the following command.
121-
122-
```shell copy
123-
ghe-config app.packages.enabled true
124-
```
95+
> If you don't configure {% data variables.product.prodname_registry %} on the staging instance before restoring your production backup, your staging instance will use your production instance's external storage, which could result in loss of data. We strongly recommended that you use different external storage for your staging instance. For more information, see [AUTOTITLE](/admin/github-actions/advanced-configuration-and-troubleshooting/using-a-staging-environment).
96+
97+
To configure {% data variables.product.prodname_registry %} for your staging instance:
98+
99+
1. Access the {% data variables.enterprise.management_console %}. See [Accessing the Management Console](/admin/administering-your-instance/administering-your-instance-from-the-web-ui/accessing-the-management-console).
100+
1. In the sidebar, open the **Packages** tab.
101+
1. Enable GitHub Packages by checking the **Enable GitHub Packages** box.
102+
1. Under **Packages Storage Settings**, select your external storage provider.
103+
1. Test your storage configuration by clicking **Test storage settings**.
104+
1. Click **Save settings** to apply your configuration.
105+
106+
> [!NOTE]
107+
> You can use ecosystem toggles to enable, disable, or set individual package types to read-only for your instance as needed.
125108
126109
### 5. Restore your production backup
127110

0 commit comments

Comments
 (0)