Configuring a Remote Repository - archimatetool/archi-modelrepository-plugin2 GitHub Wiki

Configuring a Remote Repository

An Archi model that has been added to the Collaboration Workspace also needs to be linked to an online Git repository so that local changes can be published (pushed) and refreshed (pulled). In order to implement this you need to create a blank online remote Git repository.

The following example uses GitHub.

  1. Login to your GitHub account
  2. Select "Repositories" and then "New Repository"
  3. Configure the repository as required but with no additional files or commits. It doesn't need a license, a README file or a .gitignore file. It should probably be private.
  4. Ensure that the default branch is named "main"
  5. Copy the URL of the repository. It can be HTTPS or SSH. For example:
HTTPS - https://github.com/YourAccount/repo.git
SSH -   [email protected]:YourAccount/repo.git
  1. Select the repository in the Collaboration Workspace and ensure the Properties panel is open.
  2. Add the URL to the URL field of the "Repository" tab in the Properties panel
  3. Ensure that the correct authentication details are set in the "Authentication" tab in the Properties panel

See Repository Properties for more details on setting these properties.

Once the remote repository has been correctly configured you can perform actions such as "Refresh" and "Publish".

Configuring a Remote Repository in a Local File Location

If you like you can create a remote repository on the local file system for testing purposes. This requires that you have Git installed.

  1. From the terminal type in git init /pathto/localrepo --bare -b main. This will create a "bare" repository at /pathto/localrepo.
  2. Enter the location /pathto/localrepo into the URL field of the "Repository" tab in the Properties panel
  3. Now you can Publish your local repository to this repository