Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

redhat_subscription_manager (10) Versions 0.7.0

Provides custom resources to interact with Red Hat Subscription Manager (RHSM) and Red Hat Satellite

Berkshelf/Librarian
Policyfile
Knife
cookbook 'redhat_subscription_manager', '~> 0.7.0'
cookbook 'redhat_subscription_manager', '~> 0.7.0', :supermarket
knife cookbook site install redhat_subscription_manager
knife cookbook site download redhat_subscription_manager
README
Dependencies
Changelog
Quality 67%

redhat_subscription_manager cookbook

The Red Hat Subscription Manager (RHSM) cookbook provides custom resources for use in recipes to interact with RHSM or a locally-installed Red Hat Satellite. These resources allow you to configure your hosts' registration status, repo status, and installation of errata.

Scope

This cookbook focuses on Red Hat Enterprise Linux hosts with support for the subscription-manager tool and the new style of registration and subscription management. It does not support the former rhn_register or spacewalk-channel method of channel registration.

Requirements

  • Chef 12.0.0 or higher
  • Outbound internet access (if not using a locally-accessible Satellite)
  • Outbound access to the Satellite host (if using a Satellite)
  • Valid Red Hat entitlements/subscriptions

Usage

Place a dependency on the redhat_subscription_manager cookbook in your cookbook's metadata.rb:

depends 'redhat_subscription_manager', '~> 0.1'

Then, in a recipe:

rhsm_register 'myhost' do
  activation_key 'mykey1234'
  satellite_host 'satellite.mycompany.com'
  action :register
end

Resources

rhsm_register

The rhsm_register resource performs the necessary tasks to register your host with RHSM or your local Satellite server.

Actions

  • :register: (default) registers your host
  • :unregister: unregisters your host

Parameters

  • activation_key: string of the activation key to use when registering, or an array of keys if multiple keys are needed. When using activation_key, you must supply an organization.
  • satellite_host: (optional) FQDN of the Satellite host to register with. If not specified, the host will be registered with Red Hat's public RHSM service.
  • organization: organization to use when registering, required when using an activation key
  • username: username to use when registering. Not applicable if using an activation key. If specified, password and environment are also required.
  • password: password to use when registering. Not applicable if using an activation key. If specified, username and environment are also required.
  • environment: environment to use when registering, required when using username and password
  • auto_attach: if true, RHSM will attempt to automatically attach the host to applicable subscriptions. It is generally better to use an activation key with the subscriptions pre-defined.
  • install_katello_agent: if true, the katello-agent RPM will be installed. Defaults to true
  • sensitive: if true, the execution of the registration command will be flagged as "sensitive," prohibiting the command, STDOUT, and STDERR from being displayed in the Chef log output. This command could contain usernames, passwords, and activation keys, so unlike other Chef resources, this defaults to true. However, you may set it to false to get additional output if your registration attempts are failing.
  • force: if true, the system will be registered even if it is already registered. Normally, any register operations will fail if the machine is has already registered.

Examples

rhsm_register 'myhost' do
  satellite_host 'satellite.mycompany.com'
  activation_key [ 'key1', 'key2' ]
end

rhsm_register 'myhost' do
  username 'myuser'
  password 'mypassword'
  environment 'myenvironment'
  auto_attach true
end

rhsm_register 'myhost' do
  action :unregister
end

rhsm_subscription

The rhsm_subscription resource will add another subscription to your host. This can be used when a host's activation_key does not attach all necessary subscriptions to your host.

Actions

  • :attach: (default) attach a new subscription
  • :remove: remove an existing Subscription

Parameters

None. The name passed in to the resource will be the pool ID to use when attaching/removing.

Examples

rhsm_subscription 'pool123' do
  action :attach
end

rhsm_subscription 'pool321' do
  action :remove
end

rhsm_repo

The rhsm_repo resource enabled and disables repositories that are made available via attached subscriptions.

Actions

  • :enable: (default) enable a repo
  • :disable: disable a repo

Parameters

None. The name passed in to the resource will be the repository name to use when enabling/disabling.

Examples

rhsm_repo 'rhel-7-myrepo' do
  action :enable
end

rhsm_repo 'rhel-7-oldrepo' do
  action :disable
end

rhsm_errata

The rhsm_errata resource will ensure packages associated with a given Errata ID are installed. This is helpful if packages to mitigate a single vulnerability must be installed on your hosts.

Actions

  • :install: (default) install all packages for a given erratum

Parameters

None. The name passed in to the resource will be the Errata ID to use when installing packages.

Examples

rhsm_errata 'RHSA:2015-1234'

rhsm_errata 'RHSA:2015-4321' do
  action :install
end

rhsm_errata_level

The rhsm_errata_level resource will install all packages for all errata of a certain security level. For example, you can ensure that all packages associated with errata marked at a "Critical" security level are installed.

Actions

  • :install: (default) install all packages for all errata of a certain security level

Parameters

None. The name passed in to the resource will be the security level to use when installing packages.

Valid security levels are: critical, moderate, important, and low. While yum is case sensitive, the values expected by this cookbook are not.

Examples

rhsm_errata_level 'critical'

rhsm_errata_level 'IMPORTANT' do
  action :install
end

Attributes

  • node['rhsm']['lang'] - Sets the environment language with that subscription-manager commands are executed. The output of that command is localized and non English output breaks the output parsing of this cookbook. Therefore changing the default may break this cookbook. Defaults to 'en_US'.

License and Authors

Author:: Chef Partner Engineering (partnereng@chef.io)

Copyright:: Copyright (c) 2015 Chef Software, Inc.

License:: Apache License, Version 2.0

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Contributing

  1. Fork it ( https://github.com/chef-partners/redhat-subscription-manager-cookbook/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Change Log

v0.7.0

Full Changelog

Closed issues:

  • Registration fails in non-English environments #32

Merged pull requests:

  • override languages in environment when running commands #33 (kleini)

v0.6.1 (2017-10-24)

Full Changelog

Closed issues:

  • Expose "name" attribute for "--name" argument of subscription-manager #26
  • Kattello Agent install fails because the repo isn't registered yet #25

Merged pull requests:

v0.6.0 (2017-04-24)

Full Changelog

Merged pull requests:

  • add force registration option #24 (bcg62)

v0.5.0 (2016-03-02)

Full Changelog

Closed issues:

  • Applying critical errata sometimes fails #16

Merged pull requests:

v0.4.0 (2016-02-17)

Full Changelog

Closed issues:

  • Error running in RHEL7 #12
  • When registering with username/password - passwords w/ '&' in them fail #10
  • When registering to Redhat's RHSM with u/p - environment not supported #9

Merged pull requests:

  • Don't pull and install a katello cert if it's already installed. #17 (adamleff)
  • fixing travis notifications #15 (adamleff)
  • Fixing auto-attach scope, and making sensitivity configurable #14 (adamleff)
  • Correcting environment parameter usage during registration #11 (adamleff)

v0.3.0 (2016-01-22)

Full Changelog

Closed issues:

  • Errata Install Doesn't Work On RHEL6 #7
  • Require yum-plugin-security to be installed #5

v0.2.0 (2015-12-21)

Full Changelog

Closed issues:

  • Guard katello-agent install? #3

Merged pull requests:

  • Adding ability to not install katello-agent #4 (adamleff)

v0.1.1 (2015-11-24)

Full Changelog

Merged pull requests:

  • Using file_cache_path instead of /tmp to satisfy FC013 #2 (adamleff)

v0.1.0 (2015-11-24)

Merged pull requests:

* This Change Log was automatically generated by github_changelog_generator

Collaborator Number Metric
            

0.7.0 passed this metric

Contributing File Metric
            

0.7.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

0.7.0 passed this metric

License Metric
            

0.7.0 passed this metric

No Binaries Metric
            

0.7.0 passed this metric

Publish Metric
            

0.7.0 passed this metric

Supported Platforms Metric
            

0.7.0 failed this metric

redhat_subscription_manager should declare what platform(s) it supports.

Testing File Metric
            

0.7.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

0.7.0 passed this metric