This Hammer CLI plugin contains set of commands for foreman_templates, a plugin to Foreman for syncing the contents of the Foreman Community Templates repository (or a git repo of your choice).
This is the list of which version of Foreman Templates is needed to which version of this plugin.
Hammer Templates | 0.1.0+ | 0.2.0+ |
---|---|---|
Foreman Templates | 5.0.2+ | 8.0.0+ |
$ gem install hammer_cli_foreman_templates
$ mkdir -p ~/.hammer/cli.modules.d/
$ cat <<EOQ > ~/.hammer/cli.modules.d/foreman_templates.yml
:foreman_templates:
:enable_module: true
EOQ
# to confirm things work, this should return useful output
hammer import-templates --help
hammer export-templates --help
See our Hammer CLI installation and configuration instuctions.
With this guide, you'll be able to set up hammer_cli_foreman_templates with hammer-cli-foreman for development.
These are the requirements for this setup. Note that some may not be needed at all depending on your setup.
First, cd into the directory where your projects will live. Then clone everything.
git clone https://github.com/theforeman/hammer-cli-foreman.git
git clone https://github.com/theforeman/hammer-cli-foreman-templates.git
Before we bundle, we need to setup our local Gemfile. Edit Gemfile.local.rb
in your hammer_cli_foreman_templates directory to point to the local projects instead of using the gems. Enter the following:
gem 'hammer_cli_foreman', :path => '../hammer-cli-foreman'
Now, let's create the directories we need for configuration.
mkdir -p ~/.hammer/cli.modules.d
Edit ~/.hammer/cli_config.yml
and enter any hammer-cli config values you
want.
Next edit ~/.hammer/cli.modules.d/foreman.yml
and enter the following:
:foreman:
:enable_module: true
:host: 'http://foreman.example.com/'
:username: 'admin'
:password: 'changeme'
Edit ~/.hammer/cli.modules.d/foreman_templates.yml
and enter in the following:
:foreman_templates:
:enable_module: true
And then finally test out your installation:
bundle exec hammer -vh
You should see in the output:
Extension module hammer_cli_foreman_templates (version) loaded
If you see no errors, you should be good to go.