Skip to content

iclanzan/grunt-git-deploy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

grunt-git-deploy

Deploy files to any branch of any remote git repository.

Getting Started

This plugin requires Grunt ~0.4.1 and must be used with Git 1.8.3 or better (see Git changelog).

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-git-deploy --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-git-deploy');

The "git_deploy" task

Overview

The way this task works is it creates an empty git repository in the src directory you specify, creates an orphan branch and commits all files from that directory to it. Then it pushes the branch to the configured remote repository. Be careful as this destroys the history of the remote branch.

In your project's Gruntfile, add a section named git_deploy to the data object passed into grunt.initConfig().

grunt.initConfig({
  git_deploy: {
    your_target: {
      options: {
        url: '[email protected]:example/repo.git'
      },
      src: 'directory/to/deploy'
    },
  },
})

Options

options.url

Type: String

The URL to a remote git repository. This option is required.

options.branch

Type: String Default value: 'gh-pages'

The branch to push to.

options.message

Type: String Default value: 'autocommit'

Commit message.

options.tag

Type: Boolean/String Default value: false

Whether to tag the release. Provide a tag name (string) to tag the release commit. To use the package version, first read the package.json

grunt.initConfig({
  pkg: grunt.file.readJSON("package.json")
  ...
})

and then pass the value '<%= pkg.version %>'

options.tagMessage

Type: String Default value: 'autocommit'

The message for the tag referenced above. This option is ignored if options.tag is false.

Contributing

If you can think of a way to unit test this plugin please take a shot at it.

About

Deploy files to any branch of any remote git repository.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published