Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update rename-organizations-and-repositories.adoc #8747

Merged
merged 3 commits into from
May 20, 2024
Merged

Update rename-organizations-and-repositories.adoc #8747

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
e716676
Update rename-organizations-and-repositories.adoc
sebastian-lerner May 3, 2024
f087fb1
add matrix for renaming support
rosieyohannan May 8, 2024
24178ec
Merge branch 'master' into sebastian-lerner-patch-14
rosieyohannan May 9, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 34 additions & 6 deletions jekyll/_cci2/rename-organizations-and-repositories.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,17 +12,43 @@ contentTags:

This page details everything you need to know about renaming organizations and repositories connected to CircleCI. Renaming works differently depending on how your account is connected:

* GitHub App
* GitLab
* GitHub OAuth app
* Bitbucket
[.table.table-striped]
[cols=5*, options="header", stripes=even]
|===
| VCS integration | Rename organization | Rename repository | Rename project | Notes

NOTE: To find out if you authorized through the GitHub OAuth app or the CircleCI GitHub App, see the xref:github-apps-integration#[GitHub App integration] page.
| GitHub App
| icon:thumbs-up[role="circle-green"]
| icon:thumbs-up[role="circle-green"]
| icon:thumbs-down[role="circle-red"]
| Changing the name of a repository does not affect the name of the project in CircleCI. The project name remains the same.

| GitLab
| icon:thumbs-up[role="circle-green"]
| icon:thumbs-up[role="circle-green"]
| icon:thumbs-down[role="circle-red"]
| Changing the name of a repository does not affect the name of the project in CircleCI. The project name remains the same.

| GitHub OAuth app
| icon:thumbs-up[role="circle-green"]
| icon:thumbs-up[role="circle-green"]
| icon:thumbs-up[role="circle-green"]
| Org and repository names map directly to org and project names in CircleCI. Changing either by following <<rename-organizations-and-repositories,these steps>> will update the corresponding name in CircleCI.

| Bitbucket
| icon:thumbs-up[role="circle-green"]
| icon:thumbs-up[role="circle-green"]
| icon:thumbs-up[role="circle-green"]
| Org and repository names map directly to org and project names in CircleCI. Changing either by following <<rename-organizations-and-repositories,these steps>> will update the corresponding name in CircleCI.

|===

TIP: To find out if you authorized through the GitHub OAuth app or the CircleCI GitHub App, see the xref:github-apps-integration#[GitHub App integration] page.

[#github-app-or-gitlab]
== GitHub App or GitLab

For accounts authorized through the GitHub App or GitLab, no changes are required when organizations or repositories are renamed in the connected VCS (version control system). CircleCI organizations and projects are _standalone_ entities, not directly tied to code repo or org names.
For accounts authorized through the GitHub App or GitLab, no changes are required when organizations or repositories are renamed in the connected VCS (version control system). CircleCI organizations and projects are _standalone_ entities, not directly tied to code repository or org names.

You can rename your organization from the CircleCI web app:

Expand All @@ -38,6 +64,8 @@ If you need to rename a GitHub (OAuth app) or Bitbucket organization or reposito
[#rename-organizations-and-repositories]
=== Steps to rename organizations and repositories

NOTE: It is **not** possible to rename projects that use CircleCI's GitHub App or GitLab integrations. The following instructions are for orgs and projects that use CircleCI's GitHub OAuth App or Bitbucket integrations.

. Rename organization or repository in your VCS
. Go to the CircleCI web app using the new org/repo name, for example: `app.circleci.com/pipelines/<VCS>/<new-org-name>/<project-name>`
. Confirm that your plan, projects, and settings have been transferred successfully
Expand Down