Git Call

Overview

With the Git Call node, you can easily fetch and execute code from any Git repository, be it GitHub or any other platform. All you need to do is specify the needed repository, write a program that uses it (or include it in the repository), and give proper build instructions.

When working with the Git Call node, don’t be afraid of the following:

• If you're not a Git pro, the Git Call node is designed to be user-friendly and easy to work with. So, you can quickly and effectively access and execute code from any Git repository without much hassle.
• The intricacies of the node's internal Processes may appear intimidating to those unfamiliar with Docker containerization, but you don't need to understand them to work with the Git Call node. All you need to know is that it works as a miniature computer that effectively executes your code.

Settings

The Git Call node has the following parameters:

1. (Optional) Title and Description: Name and details of the node.

2. Basic settings:

   • Language: The following programming languages are supported with their Package Managers (PM) and OS:

     • JavaScript (node) v18.16; PM: yarn, npm; OS: alpine v3.17
     • GoLang v1.20; PM: go mod; OS: alpine v3.17
     • Python v.3.11.2; PM: pip; OS: alpine v3.17
     • PHP v8.1.16; PM: composer v2.5.4; OS: alpine v3.17
     • Java v19; PM: gradle; OS: alpine v3.15
     • Closure v1.11.1; PM: lein 2.10.0; OS: alpine v3.17
     • Lisp v2.0.5; PM: roswell v20.05.14.106; OS: Ubuntu v18.04.4
     • Prolog; PM: swipl v9.1.8; OS: debian:bullseye-slim

   • Code editor: You can easily incorporate your custom code with the existing codebase from the Git repository and execute it seamlessly as a part of the overall workflow, meaning:

     • js: usercode.js
     • go: usercode.go
     • python: usercode.py
     • php: usercode.php
     As another option, you can include the Usercode file in your Git repository, which allows you to manage and control versions of your custom code alongside the main codebase. If the file Usercode is already included in the Git repository, but you also write code in the Code editor, the original file will be overwritten.
     To correctly integrate and execute your custom code within the Git Call node, it must be written within a wrapper. You can find detailed examples of the appropriate wrapper syntax for each programming language on our GitHub page.

   • Get SSH key: Generates an SSH key that can be added to your private Git repository and automatically authenticates the node.

   • Repo URL: Indicates the URL of the Git repository that you will retrieve. If you choose to authenticate your request to access the repository with a username and password, you can do so by adding them to the URL in the following format:

     https://username:password@github.com/account/repository
     

     For security reasons, it is not recommended to include credentials in the URL. Instead, we suggest using an SSH key to authenticate your requests.

   • Tag Branch Commit: Indicates a specific branch from your repository; in most cases, it should be Main.

   • Handler (Java): The name of the class that implements UsercodeHandler.

   • (Optional) Build command: Commands to build your code and install any missing libraries by using Package Manager. It uses sh (Bourne Shell) and provides a non-interactive environment. After clicking Build, a terminal window opens, and you can monitor the execution of your commands. Unlike a typical terminal, you cannot interact with it, and you need to specify your commands together.
     Note: There is no access to the root repository.

3. Other:

   • Alert if the number of tasks in the node queue reaches the following number: Helps monitor whether the number of tasks in the node exceeds the specified threshold. When selecting the checkbox, you have to enter the needed number of tasks in the field that appears below.
   • Maximum interval, for which the task stays in the node before being forwarded: The amount of time a task is allowed to be in the node; can be set in seconds, minutes, hours, and days.
     Note: The checkbox has a minimum value of 30 seconds. You can set a shorter interval by using the Unixtime function.

   

Examples

Accessing the Python library
Below, you can see the example of the Git Call node used to install a library and write code that uses it.

Error handling & troubleshooting

When an error occurs in the Git Call node, a task goes to the auxiliary Condition output node that is used for storing error parameters.

When an error occurs during the task processing, you may see the following error parameter names in the task.