Configuring Version Control for TDV Resources

Through the Manage connections window you can add, delete, and copy connections to your version control systems.

To configure version control

1. Open Studio.
2. Select VCS.
3. Select Manage Connections.
4. Click Add.
5. Type or select values for the following:

Field

GIT Example

SVN Example

Name

vcs-git

vcs-svn

Description

files from git

files from svn

Type

GIT

Subversion

URL

dv-vcs.beesknees.com/git/vcs.git

svn://192.25.5.76:3690

User

gituser2

svnuser1

Password

foa23f9u

foa23f9u
6. Refer Configuring VCS for Github OAuth Authentication for instructions on making a Github OAuth VCS connection.
7. Select Verify.

This action sets the credential that TDV uses for VCS during the Studio session that you currently have open. If you close and reopen Studio, you might be asked to log in to the VCS repository again.

8. Select a branch (applicable for GIT connection).
9. Select Create.
10. Select Close when you are done.

Configuring VCS for Github OAuth Authentication

In order to configure a VCS connection using the Github OAuth authentication, you will need a valid Github account. Follow these steps to complete the configuration in TDV:

  1. Choose Manage Connections from the VCS menu in TDV Studio. The “Manage Version Control Connections” window is displayed.

  2. Enter a Name and Description for the connection.

  3. Choose Git (Open Source) in the Type drop down.

  4. Provide the Url for the Github repository. You will need to create a repository using your Github profile. For information on creating a repository, refer:

  5. https://docs.github.com/en/get-started/quickstart/create-a-repo

  6. You will also need the Client Id and Client Secret of your repository, if you are using OAuth authentication. For more information on creating the Id and Secret, refer:

  7. https://docs.github.com/en/rest/guides/basics-of-authentication

  8. To complete the connection, provide your Github user id and Personal Access Token that you can retrieve from your Github profile. Enter the Personal Access Token in the Password field. For instructions on how to create Personal Access Token, refer to the instructions given in the section Creating a Personal Access Token for Github Authentication.

Note: You can use the OAuth authentication without giving the personal access token. To do this, click on the OAuth checkbox. You will be transferred to the browser to make a secure connection to your Github repository.

11. Click on Verify to verify your connection.

Note: If you get connection issues, verify your credentials and ensure that the secret or the token has not expired. If you continue to have issues, clear your cookie and site data in the browser settings and re-verify your connection.

12. Select a branch of your repository.
13. Set the Encryption password.
14. Click Create to create the VCS connection.

Once a VCS connection is created, all operations (such as Attach, Detach, Commit, Check-in, etc.) can be performed on the VCS instance.

Creating a Personal Access Token for Github Authentication

To create a Personal Access token and use it to Manage your TDV VCS connection, follow these steps:

  1. Create a Personal Access Token using the instructions outlined here.

  2. You will need to authorize the personal access token for use with SAML single sign on (SSO). To do this, follow these instructions.

  3. To manage teams and people with access to your repository, follow these instructions.