Blog

Brad Wood

December 17, 2016

Spread the word


Share your thoughts

Snuggle up with a warm cup of eggnog (if you're into that sort of thing) because here comes the 3rd installment of our 12 Tips of (CommandBox) Christmas aimed at lifting holiday spirits and empowering developers.  Today we look at the sweet GitHub integrations we offer.

GitHub Integration

We support installing packages directly from any Git repository via our Git endpoint.  We even let you target branches, tags, and specific commits which can make it easy to grab the bleeding edge version of packages as soon as changes are committed:

CommandBox> install git://site.com/user/repo.git#development
CommandBox> install git://site.com/user/repo.git#v1.2.3
CommandBox> install git://site.com/user/repo.git#09d302b4fffa0b988d1edd8ea747dc0c0f2883ea

GitHub shortcuts

GitHub specifically is a very popular service for devs who want Git-hosted repos.  When installing a package from GitHub you can simplify the URL above to be just the user name followed by the repo name like so:

CommandBox> install user/repo
CommandBox> install user/repo#development
CommandBox> install user/repo#v1.2.3
CommandBox> install user/repo#09d302b4fffa0b988d1edd8ea747dc0c0f2883ea

When we see this pattern, we'll convert it to the full Git URL behind the scenes.  

Authentication

Don't forget we also support SSH-based authentication which works for private Git repos, Bitbucket, or your own personal Gitlab server.  See the instructions at the bottom of this page.  The short version is that it should "just work" the same as the Git CLI by picking up the SSH keys in your user's .ssh folder.

Release Life Cycle

You're certainly not required to use Git for your projects, but if you do you'll have some nice perks such as auto-tagging your Git repos when you bump your package's version.  You can create a new version of any package by using the "bump" command.  This will increment the major, minor, or patch version number in your box.json file using semantic version rules.  If the folder also happens to be a Git repo, the command will create a new Git tag and commit it for you.

CommandBox> bump --patch
Set version = 1.0.1
Package is a Git repo.  Tagging...
Tag [v1.0.1] created.

Read more about this behavior here.

https://ortus.gitbooks.io/commandbox-documentation/content/packages/managing_version.html

 

 

 

 

Add Your Comment

Recent Entries

Into the Box 2024 Last Early Bird Days!

Into the Box 2024 Last Early Bird Days!

Time is ticking, with less than 60 days remaining until the excitement of Into the Box 2024 unfolds! Don't let this golden opportunity slip away; our exclusive Early Bird Pricing is here for a limited time only, available until March 31st. Why wait? Secure your seat now and take advantage of this steal!

Maria Jose Herrera
Maria Jose Herrera
March 20, 2024
Ortus February Newsletter 2024

Ortus February Newsletter 2024

Welcome to Ortus Solutions’ monthly roundup, where we're thrilled to showcase cutting-edge advancements, product updates, and exciting events! Join us as we delve into the latest innovations shaping the future of technology.

Maria Jose Herrera
Maria Jose Herrera
March 06, 2024
Unveiling the Future of CFML Development - 3rd Round of Sessions

Unveiling the Future of CFML Development - 3rd Round of Sessions

Welcome back to our journey into the future of CFML development! As excitement continues to build for Into the Box 2024, we're thrilled to bring you the latest updates on what promises to be a transformative event. Continuing our blog post series, let's delve deeper into the third wave of session releases and discover the key surprises awaiting attendees. Learn More

Maria Jose Herrera
Maria Jose Herrera
March 01, 2024