Open topic with navigation

Creating local repositories

To be able to store your projects, you need to create both remote and local GIT repositories.

In this page, we deal with creating local repositories.

You can learn how to create a remote repository here.

Before you start

GIT repositories are intended to secure a successful team work.

To be able to trace any commits to their authors, you have to set the user's name on every working station:

ClosedStep 1. Open the LyciaStudio preferences.

ClosedStep 2. Go to Team→Git→Configuration.

ClosedStep 3. Press Add Entry... to add user's name and email.

ClosedStep 4. Add the configuration entry by specifying necessary keys and setting values.

ClosedStep 5. After the entry was added, you'll see the user's name and email in the GIT user settings tab.

ClosedStep 6. Press OK to finish the GIT configuration at this step

GIT user settings are saved to the .gitconfig file stored in your repository folder.

Local GIT repositories can be created in two ways - from the 4GL perspective and from the GIT perspective.

Method 1. Creating a local repository from the 4GL perspective

Creating the repository folder

To create a local GIT repository from the 4GL perspective, choose a 4gl project which will serve as a temporary anchor for your local GIT repository.

Even though all the actions described below seem to be conducted on and for a definite project, they end up in creating the local repository but not committing to it.

To learn how to commit to your local repository, refer here.

ClosedStep 1. Right-click the 4gl project and go to Team→Share project.

The project you use here must be disconnected from any other repository.
ClosedStep 2. Choose Git among the available plug-ins and press Next.

ClosedStep 3. Configure the future repository (see details below).

After you configured the repository, you get the added folder shown in the table as a Target Location:

ClosedStep 4. When you press Finish, your local GIT repository is created.

At Step 3, you have to configure your future repository.

ClosedA   Choose whether to create the new repository in the project folder.

In theory, your local repository can be created in any folder including the workspace.

However, with Eclipse, it is forbidden to create repositories in the workspace so, when checking the checkbox, you get this warning:

ClosedB   Choose or create a folder which will serve as your local repository.

To choose or create the folder, you click Create and determine the directory by direct typing or browsing:

ClosedC   Specify the path to your new repository

After the repository folder was created, you can add sub-folders to it:

Initializing the repository structure

To be able to work with your local GIT repository, you have to initialize its structure.

ClosedStep 1. Right-click the 4gl project and go to Team→Init Git Flow.

ClosedStep 2. Press Yes in the message window that opens in order to initialize the repository.

ClosedStep 3. Choose the names for the branches of your local repository.

Here we use the default structure for our example local repository:

  • develop branch is used to store the latest development changes;
  • feature branch is used to develop new features for the upcoming or a distant-future release;
  • hotfix branch is used to introduce immediate fixes to a live production version;
  • master branch is used to store your production-ready source code; and
  • release branch is used for minor bug fixes and preparing metadata for the next release.

You can keep on with this structure or create you own structure which will better suit your development tasks and teamwork needs.

ClosedStep 4. When you press OK, the structure of your local GIT repository is initialized

Now your local GIT repository was created and its structure was initialized, you can start committing your projects to it.

Do not forget that after you have performed these steps, your repository is still empty and the project you have used as a temporary anchor is not added to it.

Here is what you get after initializing the repository structure:

Here is what you get when the 4gl project was added to the repository:

Method 2. Creating a local repository from the GIT perspective

You can also create a new local GIT repository from the GIT perspective:

Creating the repository folder

To create a new local GIT repository, please follow these steps.

ClosedStep 1. Open the GIT perspective as described here.
 
ClosedStep 2. Press Create a new GIT repository in the toolbar of the GIT repositories view.

ClosedStep 3. To create a folder which will serve as your local repository, click Create and set the directory by direct typing or browsing

ClosedStep 4. When you press Finish, your local GIT repository is created

Initializing the repository structure

To initialize the repository structure, please follow these steps.

ClosedStep 1. Right-click the repository and go to Init Git Flow

ClosedStep 2. Press Yes in the message window that opens in order to initialize the repository.

ClosedStep 3. Choose the names for the branches of your local repository

We talked about the default GIT structure here.

ClosedStep 4. When you press OK, the structure of your local GIT repository is initialized.

 

Contact Us

Privacy Policy

Copyright © 2024 Querix, (UK) Ltd.