On this page:

Target audience:

CAST Administrators


Summary: Information and Release Notes about the Git File Extractor 1.2.x for the CAST Delivery Manager Tool. This extension is a file extractor.

Extension description

This extension provides the means to extract source code from a Git repository. In other words, file based source code that does not reside in a simple local or network folder. This extension is similar in function to the extractors for SVN and TFS that are provided "out of the box" in the CAST Delivery Manager Tool.

In what situation should you install this extension?

This extension should be used when you want to extract file based source code that is stored in a Git repository.

Technical information

Note that with regard to SSH protocol, you must ensure that you have an SSH key setup already in your GitHub account for the machine on which you will run the extension via the CAST Delivery Manager Tool. If the key is not set up and you attempt to use the SSH protocol, then an error message will be displayed.

What's new?

Git 1.2

Supported GIT hosting sites

CAST AIP compatibility

This extension is compatible with:

CAST AIP release
Supported
8.2.x(tick)
8.1.x (tick)
8.0.x(tick)
7.3.x(tick)

Download and installation instructions

Please see: 

  • This extension contains a File extractor and you should take note of the specific instructions in the installation guide that explains how to package your source code with the CAST Delivery Manager Tool when you have an existing Version.
  • The latest release status of this extension can be seen when downloading it from the CAST Extend server.

Extension interface

The following screen shots show the differences in the product when the extension is installed:

Option
Explanation
1

Enter the direct URL for your Git repository in the form:

RepositoryURL format
LocalC:/[path]/.git
http/httpshttps://github.com/<account>/TEST.git
SSHgit@github.com:<account>/TEST.git


2

Enter the commit hash of the revision you want to extract. If omitted, the HEAD revision of the selected branch is chosen.

Note that:

  • if the Branch parameter is used (see option 3 below), this parameter is ignored
  • selecting the revision based on a revision tag is currently not supported
3If the code you require is located in a specific Git branch, enter the branch name here to ensure that the code from that branch is extracted. If nothing is entered, the default main branch will be used.
4

When this option is unticked (default position), if the certificate for the GIT repository is invalid (self-signed, unknown root CA, expired), then extraction fails. If this option is ticked, extraction succeeds in cases described previously - in other words, invalid HTTPS certificates are ignored. Note that ticking this option has no effect on an extraction which already succeeds (HTTP, valid HTTPS).

5

Tick the Credentials option if the Git repository requires authenticated access.

Remember Password

This option enables you to force the CAST Delivery Manager Tool to save the access credentials you have entered above. Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions using the same repositories, you can choose to store the password in which case you will not need to re-enter it.

There are two save options:

  • Local > The credentials are saved in the user's local workspace on the current machine. Choose this option if you do not want the password to be available to other Delivery Managers.
  • Server > The credentials are saved locally (as above) and are also synchronized back to the CAST AIC Portal (i.e. the Source Code Delivery Folder). Choose this option if you want the password to be available to other Delivery Managers.