KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

git2jss

★ 92 Open GitHub ↗

Easily sync your scripts and EA's from a git repo with the JSS

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# git2jss

A fast asynchronous python library for syncing your scripts in git with your JSS easily. This allows admins to keep their script in a version control system for easy updating rather than googling and copy-pasting from resources that they find online.

## Getting Started
1.  Fork the Project
2.  Install [Python version 3.6](https://www.python.org/downloads/) or higher. (this is because of the async requirements)
3.  Run `python3.6 -m pip install -r requirements.txt` to install required modules
4.  Run `./tools/download.py --url https://your.jss.url:8443 --username api_user` to download all scripts and extension attributes to the repository
5.  Run `./sync.py --url https://your.jss.url:8443 --username api_user` to sync all scripts back to your JSS

Optional flags for `download.py`:

-   `--password` for CI/CD (Will prompt for password if not set)
-   `--do_not_verify_ssl` to skip ssl verification
-   `--overwrite` to overwrite all scripts and extension attributes

Optional flags for `sync.py`:

-   `--password` for CI/CD (Will prompt for password if not set)
-   `--do_not_verify_ssl` to skip ssl verification
-   `--overwrite` to overwrite all scripts and extension attributes
-   `--limit` to limit max connections (default=25)
-   `--timeout` to limit max connections (default=60)
-   `--verbose` to add additional logging
-   `--update_all` to upload all resources in `./extension_attributes` and `./scripts`
-   `--jenkins` to write a Jenkins file:`jenkins.properties` with `$scripts` and `$eas` and compare `$GIT_PREVIOUS_COMMIT` with `$GIT_COMMIT`

### [ConfigParser](https://docs.python.org/3/library/configparser.html) (Optional):

A config file can be created in the project root or the users home folder. When a config file exists, the script will not promt for a password.

A jamfapi.cfg file can provide the following variables:

- username
 - password
 - url

### Prerequisites
git2jss requires [Python 3.6](https://www.python.org/downloads/) and the python modules listed in `requirements.txt`

## Deployment
The project can be ran ad-hoc with the example listed above, but ideally you setup webhooks and integrate into a CI/CD pipeline so each time a push is made to the repo your scripts are re-uploaded to the JSS.

## Contributing
PR's are always welcome!

git2jss

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README