GitLab

This page describes the process to mirror a Copia repo to a GitLab repo.

Note: These instructions are provided as a basic guideline for mirroring Copia repositories to GitLab. It is up to the customer to implement the Copia repositories into their existing CI/CD workflows as they desire. Copia is providing these instructions to help customers, but we do not officially support this feature and don't guarantee these instructions to be accurate. A video demonstration of this process can be viewed here. This method is compatible with users who have two-factor authentication enabled. Note: This method has not been tested to work with repositories that utilize Git LFS.

  1. Create a Project in GitLab

  2. Add a repository to the project. This GitLab repo will be the repo to which your Copia repo is mirrored. Consider using a naming convention to indicate that you are mirroring from Copia.

  3. (This step is only necessary if the repo uses, or is ever expected to use, Git LFS.) Beneath the project on the left side of the screen, select the "Settings" icon, and then select "General"

    1. Underneath "Visibility, project features, permissions", ensure that the "Git Large File Storage (LFS)" toggle is turned on

  4. Beneath the project on the left side of the screen, select the "Settings" icon, and then select "Repository"

  5. Click the "Expand" button in the "Mirroring repositories" section

  6. In the "Git repository URL" field, add the URL of the Copia repository that you wish to mirror

  7. In the URL string that you just entered, add the username of a Copia user who has access to that repository, along with the "at" symbol. For example, if the repo that I want to mirror is https://app.copia.io/Copia/MirrorRepo-NRB, then the modified URL would be https://[email protected]/Copia/MirrorRepo-NRB

  8. Important! Make sure that you change the "Mirror Direction" to "Pull". If you leave the mirror direction as "Push", you risk overwriting commits that were made on Copia

  9. Enter the password of the Copia user who has access to the repository or enter an Access Token that can be created at https://app.copia.io/user/settings/applications (Note: Currently, Copia only generates Access Tokens that have full access to your account)

  10. Click the "Mirror repository" button

  11. The Copia repository should now be mirrored to GitLab. If the Copia repo name is ever changed, the mirror will no longer function and will need to be reconfigured with the new repo URL.

PreviousGitHub

Last updated