Chapter 16. Repository hooks

Procedure

1. Log in to Business Central.
2. Select Menu Projects.
3. Select or create the space into which you want to import the projects.
4. Click on the right side of the screen and select Import Project.

5. In the Import Project window, enter the URL (for example, https://github.com/USERNAME/REPOSITORY_NAME.git) and credentials for the Git repository that contains the project that you want to import and click Import.

   The project is added to the Business Central Git repository and is available in the created or default space.

   Important

   Use the HTTPS or Git protocol instead of a SCP-style SSH URL. Business Central does not support the basic SSH URL and an error appears if you use this URL.

6. In a terminal window, change to the created repository.

   cd JBOSS_HOME/bin/.niogit/REPOSITORY_NAME.git

   Copy to Clipboard Toggle word wrap

7. Create the post-commit file in the JBOSS_HOME/bin/.niogit/REPOSITORY_NAME.git/hooks directory, set the permissions to rwxr—​r-- and add the following content:

   #!/bin/sh
   git push origin master

   Copy to Clipboard Toggle word wrap

8. Make sure that the configuration was successful by creating a new guided rule in Business Central:

   1. Select Menu Projects Add Asset Guided Rule.
   2. Fill in the required information in the displayed Create new Guided Rule window.

   3. Click Ok.

      Business Central automatically pushes all changes to the remote repository.

Procedure

1. To enable notifications, in the standalone.xml file set the appformer.git.hooks.bundle system property to point to a *.properties file containing the custom messages for each exit code.

   For example:

   <system-properties>
     <property name="appformer.git.hooks.bundle" value="/opt/jboss-as/git-hooks-messages/Messages.properties">
     </property>
     ...
   </system-properties>

   Copy to Clipboard Toggle word wrap

2. To display the messages, each line of the *.properties must have the following format:

   <exit_code>=<display_message>

   where, <exit_code> is the git hook exit code and <display_message> is the custom message that is displayed to a user.

   Exit code messages with this format appear similar to the following example:

   0=Success
   1=Display Message 1
   .
   .
   31=Display Message 31

   Copy to Clipboard Toggle word wrap