Transferring or Renaming Repositories
Warning: When renaming or transferring repositories or organizations in your Version Control System (VCS), there's a risk of losing contexts, project build history, and settings in CircleCI. This data loss can occur due to synchronization challenges between CircleCI and your VCS, especially if the previous name is immediately reused for a different organization or repository.
Step-by-Step Guide
Follow these best practices when transferring a repository to another organization, renaming a repository/organization, or transferring ownership:
- Before Making Changes: Log into CircleCI and manually stop building and remove CircleCI webhooks for any repository you plan to transfer.
- Make Changes in Your VCS: Log into your VCS and complete the rename or transfer action. Try to avoid renaming your organization multiple times, as this increases the risk of data loss.
-
Verify in CircleCI: Log into CircleCI using your new organization name and verify that:
- All projects are visible and following correctly
- Contexts are intact
- Settings are preserved
- Billing information is up to date
- After Verification: Only after confirming everything is working properly should you create a new organization or repository using the old name in your VCS (if desired).
Accessing Your Renamed Organization
You can access CircleCI with your new organization name by:
- Navigating through CircleCI's homepage and selecting your new organization
- Using this direct URL format:
https://app.circleci.com/projects/project-dashboard/:VCS/:NEW_ORG_NAME
Helpful Resources
Comments
Article is closed for comments.