Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

On this Page

Table of Contents
maxLevel2
excludeOlder Versions|Additional Resources|Related Links|Related Information


Note

It is recommended that you to go through GitHub Options in the Snaplogic UI before referring to this page to understand the GitHub options in the SnapLogic UI.


Warning

When committing files to GitHub from SnapLogic, some subdirectories might be inadvertently deleted from the repository, including GitHub Actions workflows in the .github directory. Target fix version: 4.29.2 patch in July 2022


SnapLogic → GitHub

You can perform the following operations on files in the GitHub repository through SnapLogic:

  • Add files

  • Update files

  • Delete files


Add Files to the GitHub Repository

  1. Navigate to the project in SnapLogic Manager.

...

  1. Image Added



  2. Upload the file by clicking the + symbol. The file displays in the

...

  1. Asset table; but the GitHub

...

  1. Status reads Untracked

...

  1. Image Added



  2. Open the File options menu by clicking the downward arrow adjacent to this file in the Asset table. 

...

  1. Image Added

...



  1. Click Add to Repository. The GitHub status changes

...

  1. to Added.

...

  1. Image Added



  2. Go to

...

  1. the GitHub menu and click Commit to GitHub Repository. The Commit changes dialog box opens. The file is shown under Changes to

...

  1. Commit in the dialog box.

  2. Add

...

  1. Commit Message. 

...

  1. Image Added

...



  1. Click Commit. The file is added to

...

  1. the Asset table and the GitHub Status

...

  1. reads Tracked

...

  1. Image Added



  2. Refresh the GitHub page. The new file is displayed in the

...

  1. repository along with the commit message.

...

  1. Image Added



Note

If you omit step #3 and commit changes to the repository:

  • The GitHub Status

...

  • reads Untracked

...

  •  asset in the Asset table.

  • The file is shown under Untracked

...

  • assets in the dialog box in the Commit Changes dialog box. Select the corresponding checkbox for this asset and click Commit to commit it to the repository. GitHub status changes to Tracked.


Update Files in the GitHub Repository

  1. Navigate to the project in SnapLogic Manager.

...

  1. Image Added



  2. Upload the asset from your local storage (by clicking

...

  1. the +

...

  1.  symbol, and uploading it). Since the file already exists in your repository (and in your Asset table), an "Overwrite" dialog box is displayed.

...

  1.  Click Overwrite to confirm.

...

  1. Image Added



  2. Go to the GitHub menu and

...

  1. click Commit to GitHub. The Commit Changes dialog box opens. It automatically detects if there is a newer version of a file and lists it out in the dialog box under

...

  1. the Changes to Commit list.

...

  1. Image Added



  2. Add

...

  1. Commit Message, if required.

...


  1. Click Commit. The Asset table is updated.

...

  1. Image Added



  2. Refresh your GitHub repository. 

...

  1. Image Added


Delete Files from the GitHub Repository

  1. Navigate to the project in SnapLogic Manager.

...

  1. Image Added


     

  2. Open the File options menu by clicking the downward arrow adjacent to the file to be deleted. Click Remove from Repository. The GitHub Status changes to Removed.
    Image Modified

  3. Commit changes by going to the GitHub menu and clicking Commit to GitHub Repository. The Commit Changes dialog box opens. 

  4. Add

...

  1. Commit Message, if required.

...

  1. Image Added

...



  1. Click Commit. The GitHub Status changes to Untracked and the file is deleted from the GitHub repository. 

...

  1. Image Added



  2. Refresh your

...

  1. GitHub repository

...

  1. Image Added


GitHub → SnapLogic

You can perform the following operations on assets in a SnapLogic project through GitHub:

  • Add files

  • Update files

  • Delete files


Add Assets/Files to the Project

  1. Go to your GitHub repository.

  2. Add the file.

  3. Add a commit message.

  4. Commit changes by

...

  1. clicking Commit. The new file is displayed in your repository.

...

  1. Image Added



  2. Go to the project's Asset table in SnapLogic Manager.

  3. In the GitHub menu

...

  1. click GitHub Pull.

...

  1.  The GitHub Pull dialog box opens, displaying the files that were added in the Asset list.|

...

  1. Image Added

...



  1. Click OK

...

  1.  to close the dialog box. The file is added to the Asset table.

...

  1. Image Added


Update Assets/Files in the Project

  1. Go to your GitHub repository.

  2. Update the file.

  3. Add a commit message and commit changes by

...

  1. clicking Commit. The updated file is displayed in the repository.

...

  1. Image Added



  2. Go to the project's Asset table in SnapLogic Manager.

  3. In GitHub menu options

...

  1. click GitHub Pull.

...

  1.  The GitHub Pull dialog box opens, displaying the files that were updated in the Asset list.

...

  1. Image Added

...



  1. Click OK

...

  1.  to close the dialog box. The file is updated in the Asset table.

...

  1. Image Added


Delete Assets/Files from the Project 

  1. Go to your GitHub repository.

  2. Delete the file.

  3. Add a commit message and commit changes by

...

  1. clicking Commit. The file is deleted from the repository.

...

  1. Image Added



  2. Go to the project's Asset table in SnapLogic Manager.

  3. In the GitHub menu

...

  1. click GitHub Pull.

...

  1.  The GitHub Pull dialog box opens, displaying the file that was deleted in the Asset list.

  2. Click OK to close the dialog box. The file is deleted from the Asset table.

...

  1. Image Added


Conflict Resolution in Pull Requests

It may happen that you have updated an asset in SnapLogic and also updated the same file in your GitHub repository. This causes a conflict when you perform a pull operation. In such scenarios,

...

 SnapLogic lets you specify whether you want to overwrite. 

 Image Modified


To overwrite your local file with the

...

repository version,

...

 select the file and

...

click Pull.

...

Click OK

...

 in the confirmation message displayed.

...


If you do not want to overwrite the local file with the version in the GitHub repository, do not select the checkbox in

...

the GitHub Pull dialog box.

...

Click Pull. To overwrite the version in the GitHub repository, perform a Commit operation.


...

See Also