Skip to content
Branch: master
Go to file
Code

Latest commit

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

itamae-plugin-resource-portage

Portage related resources (flags, keywords, packages) plugin for itamae and mitamae.

Installation

mitamae

mkdir -p ./plugins
git submodule add https://github.com/sorah/itamae-plugin-resource-portage plugins/itamae-plugin-resource-portage
# or `git clone`

itamae

gem 'itamae-plugin-resource-portage'

prerequisites

  • eix

Usage

Basic attributes

All resources take name, slot, version, and/or atom attribtues

  • name (default_name): package name (category/name)
  • version (+ slot) or atom:
    • version: package version + operator (e.g. 1.0.0, >=1.0.0, <2.0.0)
    • slot: (optional)
    • atom: if specified, version and slot are ignored

portage_accept_keywords, portage_mask, portage_unmask, portage_use resource take additionally:

  • action: :add (default) or :remove
  • target: when absolute path given, the resource will use that path to modify (e.g. /etc/portage/package.use/foobar). Otherwise, given name under appropriate directory will be used (e.g. foobar to /etc/portage/package.XXX/foobar); Default to /etc/portage/package.XXX/itamae or /etc/portage/package.XXX (only when it exists as file)

portage resource

portage resource defines portage_package, portage_unmask, portage_accept_keywords, portage_use, and/or portage_pin resources based on given attributes.

portage "www-servers/nginx" do
end

portage "www-servers/nginx" do
  version "1.9.7" 

  flags ['nginx_modules_http_stub_status']

  # accept keywords by default, but if you want to disable:
  # keywords []

  # Mask =version and unmask !=version
  pin true
end
  • action: install (default), remove
  • unmask (nil/bool):
  • pin (bool):
  • noreplace (bool, default=true):
  • oneshot (bool, default=false):
  • flags (array)
  • keywords (array,default=[$ARCH])
  • package_use_file
  • package_mask_file
  • package_unmask_file
  • package_accept_keywords_file
  • emerge_cmd:
  • eix_cmd:

portage_accept_keywords resource

portage_accept_keywords "www-servers/nginx" do
  keywords ['~amd64']
end
  • keywords: Default to $ARCH (eix --print ARCH)

portage_mask resource

portage_pin resource

portage_package resource

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/itamae-plugin-resource-portage.

License

The gem is available as open source under the terms of the MIT License.

About

Itamae/MItamae resources for Portage (Gentoo Linux)

Topics

Resources

License

You can’t perform that action at this time.