Creating a tag in a SourceCraft repository

Tags mark key points in the repository's development history.

You can create a tag from a specific branch in the SourceCraft interface when creating a release, or in advance using git based on a branch or a specific commit.

To create a tag using git:

1. Clone the repository:

   1. Install Git.

   2. Open the SourceCraft home page.

   3. On the Home tab, under Your craftspace, navigate to Repositories and select your repository.

      Also, you can open any public repository.

   4. In the top-right corner of the repository page, click Clone.

   5. From the HTTPS or SSH field, copy the repository cloning link.

      Depending on the cloning connection protocol, different domains are used:

      Protocol	Domain	Cloning link
      HTTPS	git.sourcecraft.dev	https://git@git.sourcecraft.dev/<organization_slug>/<repository_slug>.git
      SSH	ssh.sourcecraft.dev	ssh://ssh.sourcecraft.dev/<organization_slug>/<repository_slug>.git

   6. In the terminal, run this command:

      git clone <link_for_cloning_repository>
      
      Example of a command for cloning a repository with SourceCraft documentation

      git clone https://git@git.sourcecraft.dev/sourcecraft/documentation.git
      

      Warning

      To clone a private or internal repository, authenticate with a personal access token (PAT) or SSH key.

   7. Go to your cloned repository:

      cd <repository_name>
      

2. Navigate to the commit you want to use as the basis for your release:

   • To navigate to the current state of the main branch:

     git checkout main
     

   • To navigate to a specific commit:

     git checkout <commit_hash>
     

     Tip

     For more information, see Viewing the commit history in SourceCraft.

3. Create a tag and push the changes to the remote repository:

   git tag -a <tag_name> -m "<description>"
   git push --tags
   

See also

• Working with releases in SourceCraft
• Viewing the commit history in SourceCraft