You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent.md
+39-8Lines changed: 39 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,11 +20,12 @@ redirect_from:
20
20
21
21
While working on a task, {% data variables.product.prodname_copilot_short %} has access to its own ephemeral development environment, powered by {% data variables.product.prodname_actions %}, where it can explore your code, make changes, execute automated tests and linters and more.
22
22
23
-
You can customize {% data variables.product.prodname_copilot_short %}'s environment by:
23
+
You can customize {% data variables.product.prodname_copilot_short %}'s environment to:
24
24
25
-
*[Preinstalling tools or dependencies in {% data variables.product.prodname_copilot_short %}'s environment](#preinstalling-tools-or-dependencies-in-copilots-environment).
26
-
*[Upgrading from standard {% data variables.product.prodname_dotcom %}-hosted {% data variables.product.prodname_actions %} runners to larger runners](#upgrading-to-larger-github-hosted-github-actions-runners).
27
-
*[Disabling or customizing the agent's firewall](/copilot/customizing-copilot/customizing-or-disabling-the-firewall-for-copilot-coding-agent).
25
+
*[Preinstall tools or dependencies in {% data variables.product.prodname_copilot_short %}'s environment](#preinstalling-tools-or-dependencies-in-copilots-environment).
26
+
*[Upgrade from standard {% data variables.product.github %}-hosted {% data variables.product.prodname_actions %} runners to larger runners](#upgrading-to-larger-github-hosted-github-actions-runners).
27
+
*[Enable Git Large File Storage (LFS)](#enabling-git-large-file-storage-lfs)
28
+
*[Disable or customize the agent's firewall](/copilot/customizing-copilot/customizing-or-disabling-the-firewall-for-copilot-coding-agent).
28
29
29
30
## Preinstalling tools or dependencies in {% data variables.product.prodname_copilot_short %}'s environment
30
31
@@ -41,8 +42,16 @@ Here is a simple example of a `copilot-setup-steps.yml` file for a TypeScript pr
41
42
```yaml copy
42
43
name: "Copilot Setup Steps"
43
44
44
-
# Allow testing of the setup steps from your repository's "Actions" tab.
45
-
on: workflow_dispatch
45
+
# Automatically run the setup steps when they are changed to allow for easy validation, and
46
+
# allow manual testing through the repository's "Actions" tab
47
+
on:
48
+
workflow_dispatch:
49
+
push:
50
+
paths:
51
+
- .github/workflows/copilot-setup-steps.yml
52
+
pull_request:
53
+
paths:
54
+
- .github/workflows/copilot-setup-steps.yml
46
55
47
56
jobs:
48
57
# The job MUST be called `copilot-setup-steps` or it will not be picked up by Copilot.
@@ -83,7 +92,9 @@ In your `copilot-setup-steps.yml` file, you can only customize the following set
83
92
84
93
For more information on these options, see [AUTOTITLE](/actions/writing-workflows/workflow-syntax-for-github-actions#jobs).
85
94
86
-
Once you have created a `copilot-setup-steps.yml` file and merged it into your default branch, you can manually run the workflow from the repository's **Actions** tab to check that it works. For more information, see [AUTOTITLE](/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/manually-running-a-workflow).
95
+
Your `copilot-setup-steps.yml` file will automatically be run as a normal {% data variables.product.prodname_actions %} workflow when changes are made, so you can see if it runs successfully. This will show alongside other checks in a pull request where you create or modify the file.
96
+
97
+
Once you have merged the yml file into your default branch, you can manually run the workflow from the repository's **Actions** tab at any time to check that everything works as expected. For more information, see [AUTOTITLE](/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/manually-running-a-workflow).
87
98
88
99
## Upgrading to larger {% data variables.product.prodname_dotcom %}-hosted {% data variables.product.prodname_actions %} runners
89
100
@@ -105,9 +116,29 @@ jobs:
105
116
```
106
117
107
118
> [!NOTE]
108
-
> * {% data variables.copilot.copilot_coding_agent %} is only compatible with Ubuntu x86 Linux runners. Runners with Windows, macOS or other operating systems are not supported.
119
+
> * {% data variables.copilot.copilot_coding_agent %} is only compatible with Ubuntu x64 Linux runners. Runners with Windows, macOS or other operating systems are not supported.
109
120
> * Self-hosted {% data variables.product.prodname_actions %} runners are not supported.
110
121
122
+
## Enabling Git Large File Storage (LFS)
123
+
124
+
If you use Git Large File Storage (LFS) to store large files in your repository, you will need to customize {% data variables.product.prodname_copilot_short %}'s environment to install Git LFS and fetch LFS objects.
125
+
126
+
To enable Git LFS, add a `actions/checkout` step to your `copilot-setup-steps` job with the `lfs` option set to `true`.
127
+
128
+
```yaml copy
129
+
# ...
130
+
131
+
jobs:
132
+
copilot-setup-steps:
133
+
runs-on: ubuntu-latest
134
+
permissions:
135
+
contents: read # for actions/checkout
136
+
steps:
137
+
- uses: {% data reusables.actions.action-checkout %}
Copy file name to clipboardExpand all lines: content/discussions/managing-discussions-for-your-community/managing-discussions.md
+1-8Lines changed: 1 addition & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -159,16 +159,10 @@ To transfer a discussion, you must have permissions to create discussions in the
159
159
1. At the bottom of the discussion, below the comment box, click **Close discussion**.
160
160
1. Optionally, to change the reason for closing the discussion, select the {% octicon "triangle-down" aria-label="The down triangle octicon" %} dropdown next to "Close discussion" and click a reason.
161
161
162
-
<!-- expires 2025-06-06 -->
163
-
164
-
<!-- When this expires, remove the Converting issues based on labels section for FPT/GHEC but keep it for GHES <=3.17 -->
165
-
166
-
{% ifversion fpt or ghec %}
162
+
{% ifversion ghes < 3.18 %}
167
163
168
164
## Converting issues based on labels
169
165
170
-
>[!WARNING] Starting June 6, 2025, {% data variables.product.company_short %} will deprecate bulk converting of issues based on labels.
171
-
172
166
You can convert all issues with the same label to discussions in bulk. Future issues with this label will also automatically convert to the discussion and category you configure.
173
167
174
168
1. Navigate to the main page of the repository or, for organization discussions, the source repository.
@@ -179,4 +173,3 @@ You can convert all issues with the same label to discussions in bulk. Future is
179
173
1. Click **I understand, convert this issue to a discussion**.
Copy file name to clipboardExpand all lines: content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -78,9 +78,9 @@ If your organization has a security team, you can use the security manager role
78
78
79
79
### {% data variables.product.prodname_github_app %} managers
80
80
81
-
By default, only organization owners can manage the settings of {% data variables.product.prodname_github_app %} registrations owned by an organization. To allow additional users to manage {% data variables.product.prodname_github_app %} registrations owned by an organization, an owner can grant them {% data variables.product.prodname_github_app %} manager permissions.
81
+
By default, only organization owners can manage the settings of {% data variables.product.prodname_github_app %} registrations owned by an organization. To allow additional users{% ifversion org-app-manager-teams %} or teams{% endif %} to manage {% data variables.product.prodname_github_app %} registrations owned by an organization, an owner can grant them {% data variables.product.prodname_github_app %} manager permissions.
82
82
83
-
When you designate a user as a {% data variables.product.prodname_github_app %} manager in your organization, you can grant them access to manage the settings of some or all {% data variables.product.prodname_github_app %} registrations owned by the organization. The {% data variables.product.prodname_github_app %} manager role does not grant users access to install and uninstall {% data variables.product.prodname_github_apps %} on an organization. For more information, see [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/adding-and-removing-github-app-managers-in-your-organization).
83
+
When you designate a user{% ifversion org-app-manager-teams %} or team{% endif %} as a {% data variables.product.prodname_github_app %} manager in your organization, you can grant them access to manage the settings of some or all {% data variables.product.prodname_github_app %} registrations owned by the organization. The {% data variables.product.prodname_github_app %} manager role does not grant users access to install and uninstall {% data variables.product.prodname_github_apps %} on an organization. For more information, see [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/adding-and-removing-github-app-managers-in-your-organization).
Copy file name to clipboardExpand all lines: content/organizations/managing-programmatic-access-to-your-organization/adding-and-removing-github-app-managers-in-your-organization.md
## Giving someone the ability to manage all {% data variables.product.prodname_github_apps %} owned by the organization
28
+
## Granting the ability to manage all {% data variables.product.prodname_github_apps %} owned by the organization
29
29
30
+
{%- ifversion org-app-manager-teams %}
31
+
To assign the App Manager organization role to a user or team, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles#assigning-an-organization-role).
32
+
33
+
Use the role assignments page to see who has been granted this and any other organization role. Organization owners can always manage {% data variables.product.prodname_github_apps %} and are not shown in this view.
34
+
{%- else %}
30
35
{% data reusables.profile.access_org %}
31
36
{% data reusables.profile.org_settings %}
32
37
{% data reusables.organizations.github-apps-settings-sidebar %}
33
38
1. At the bottom of the "Management" section, in the search field, type the username of the person you want to designate as a {% data variables.product.prodname_github_app %} manager in the organization, then click **Grant**.
39
+
{%- endif %}
34
40
35
-
## Giving someone the ability to manage an individual {% data variables.product.prodname_github_app %}
41
+
## Granting the ability to manage an individual {% data variables.product.prodname_github_app %}
36
42
37
43
{% data reusables.profile.access_org %}
38
44
{% data reusables.profile.org_settings %}
39
45
{% data reusables.organizations.github-apps-settings-sidebar %}
40
46
1. Under "{% data variables.product.prodname_github_apps %}", click on the avatar of the app you'd like to add a {% data variables.product.prodname_github_app %} manager for.
41
47
{% data reusables.organizations.app-managers-settings-sidebar %}
42
-
1. At the bottom of the "App managers" section, in the search field, type the username of the person you want to designate as a GitHub App manager for the app, then click **Grant**.
48
+
1. At the bottom of the "App managers" section, in the search field, type the username of the person{%- ifversion org-app-manager-teams %} or team{%- endif %} you want to designate as a GitHub App manager for the app, then click **Grant**.
43
49
44
50
## Removing a {% data variables.product.prodname_github_app %} manager's permissions for the entire organization
45
51
52
+
{%- ifversion org-app-manager-teams %}
53
+
See [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles#deleting-an-organization-role-assignment) for directions on removing the App Manager role from a user or team.
54
+
{%- else %}
46
55
{% data reusables.profile.access_org %}
47
56
{% data reusables.profile.org_settings %}
48
57
{% data reusables.organizations.github-apps-settings-sidebar %}
49
58
1. Under "Management", next to the person you want to remove {% data variables.product.prodname_github_app %} manager permissions from, click **Revoke**.
59
+
{%- endif %}
50
60
51
-
## Removing a {% data variables.product.prodname_github_app %} manager's permissions for an individual {% data variables.product.prodname_github_app %}
61
+
## Removing managers from an individual {% data variables.product.prodname_github_app %}
52
62
53
63
{% data reusables.profile.access_org %}
54
64
{% data reusables.profile.org_settings %}
55
65
{% data reusables.organizations.github-apps-settings-sidebar %}
56
66
1. Under "{% data variables.product.prodname_github_apps %}", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from.
57
67
{% data reusables.organizations.app-managers-settings-sidebar %}
58
-
1. Under "App managers", next to the person you want to remove {% data variables.product.prodname_github_app %} manager permissions from, click **Revoke**.
68
+
1. Under "App managers", next to the person{%- ifversion org-app-manager-teams %} or team{%- endif %} you want to remove {% data variables.product.prodname_github_app %} manager permissions from, click **Revoke**.
Organization owners can designate other usersin their organization as {% data variables.product.prodname_github_app %} managers. {% data variables.product.prodname_github_app %} managers can manage the settings of some or all of the {% data variables.product.prodname_github_app %} registrations that are owned by the organization. The {% data variables.product.prodname_github_app %} manager role does not grant users access to install and uninstall {% data variables.product.prodname_github_apps %} on an organization. For more information about the specific app settings that a {% data variables.product.prodname_github_app %} manager can control, see [AUTOTITLE](/apps/maintaining-github-apps/modifying-a-github-app).
1
+
Organization owners can designate other users{% ifversion org-app-manager-teams %} or teams{% endif %} in their organization as {% data variables.product.prodname_github_app %} managers. {% data variables.product.prodname_github_app %} managers can manage the settings of some or all of the {% data variables.product.prodname_github_app %} registrations that are owned by the organization. The {% data variables.product.prodname_github_app %} manager role does not grant recipients access to install and uninstall {% data variables.product.prodname_github_apps %} on an organization. For more information about the specific app settings that {% data variables.product.prodname_github_app %} managers can control, see [AUTOTITLE](/apps/maintaining-github-apps/modifying-a-github-app).
2
2
3
3
For more information about {% data variables.product.prodname_github_app %} manager permissions, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#github-app-managers).
Copy file name to clipboardExpand all lines: data/reusables/organizations/pre-defined-organization-roles.md
+3Lines changed: 3 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,3 +11,6 @@ The current set of pre-defined roles are:
11
11
***CI/CD admin:** Grants admin access to manage Actions policies, runners, runner groups, hosted compute network configurations, secrets, variables, and usage metrics for an organization.
12
12
***Security manager**: Grants the ability to manage security policies, security alerts, and security configurations for an organization and all its repositories.
13
13
{%- endif %}
14
+
{%- ifversion org-app-manager-teams %}
15
+
***App Manager:** Grants the ability to create, edit, and delete all GitHub Apps in an organization.
0 commit comments