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

Select Status

RSS

windows_failover_cluster (3) Versions 0.3.0

Install and configure a Windows Failover Cluster Server

Policyfile
Berkshelf
Knife
cookbook 'windows_failover_cluster', '~> 0.3.0', :supermarket
cookbook 'windows_failover_cluster', '~> 0.3.0'
knife supermarket install windows_failover_cluster
knife supermarket download windows_failover_cluster
README
Dependencies
Changelog
Quality 33%

windows_failover_cluster

Chef cookbook to install and configure a Windows Failover Cluster Server.

Table of contents

  1. Usage
  2. Attributes
  3. Recipes
  4. Resources
  5. Versioning
  6. Contributing
  7. License and Author

Usage

Attributes

Attributes in this cookbook:

Name Types Description Default
['windows_failover_cluster']['run_as_user'] String Sets the default cluster user for resources nil
['windows_failover_cluster']['run_as_password'] String Sets the default cluster user password nil

Setting these attributes allows you skip the run_as_user and run_as_password properties when using this cookbook's resources.

Recipes

This cookbook doesn't ship any recipes.

Resources

windows_failover_cluster_node

It creates a new Windows Failover Cluster or joins an existing cluster.

Actions

  • create - (default) Creates a new Windows Failover Cluster.
  • join - Joins a node to an existing cluster.

Syntax

windows_failover_cluster_node 'name' do
  cluster_ip                 String # required when using :create action
  cluster_name               String # default value: 'name' unless specified
  install_tools              true, false # default value: true
  fs_witness                 String
  quorum_disk                String
  run_as_password            String # default value: node['windows_failover_cluster']['run_as_password']
  run_as_user                String # default value: node['windows_failover_cluster']['run_as_user']
  action                     Symbol # defaults to :create if not specified
end

Examples

Create a cluster using a quorum disk:

windows_failover_cluster_node 'Cluster1' do
  cluster_ip '192.168.10.10'
  quorum_disk 'Cluster Disk 1'
  action :create
end

Create a cluster using a file share witness:

windows_failover_cluster_node 'Cluster1' do
  cluster_ip '192.168.10.10'
  fs_witness '\\\\fileserver\\witness'
  action :create
end

Join an existing cluster:

windows_failover_cluster_node 'Cluster1' do
  action :join
end

windows_failover_cluster_generic_service

It creates a generic service for a Windows Failover Cluster.

Actions

  • create - (default) Creates a new Windows Failover Cluster Generic Service.

Syntax

windows_failover_cluster_generic_service 'name' do
  service_name               [Array, String] # default value: 'name' unless specified
  checkpoint_key             [Array, String]
  role_name                  String # required
  run_as_password            String # default value: node['windows_failover_cluster']['run_as_password']
  run_as_user                String # default value: node['windows_failover_cluster']['run_as_user']
  service_ip                 String # required
  storage                    String
  action                     Symbol # defaults to :create if not specified
end

Examples

Create a generic cluster service:

windows_failover_cluster_generic_service 'Service1' do
  role_name 'Role1'
  service_ip '192.168.10.20'
  storage 'Cluster Disk 1'
  action :create
end

Versioning

This cookbook uses Semantic Versioning 2.0.0.

Given a version number MAJOR.MINOR.PATCH, increment the:

  • MAJOR version when you make functional cookbook changes,
  • MINOR version when you add functionality in a backwards-compatible manner,
  • PATCH version when you make backwards-compatible bug fixes.

Contributing

We welcome contributed improvements and bug fixes via the usual work flow:

  1. Fork this repository
  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

License and Author

Authors and contributors:

Copyright 2018, Stephen Hoekstra <stephenhoekstra@gmail.com>
Copyright 2018, Schuberg Philis

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.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

windows_failover_cluster CHANGELOG

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

0.3.0 (2019-02-15)

  • Add support to use a File Share Witness for quorum
  • Add support to configure multiple services for a single cluster resource

0.2.0 (2019-01-14)

  • Updated for Chef 14 and now requires a minimum version of Chef 14

0.1.0 (2018-11-09)

  • First release of windows_failover_cluster cookbook

Collaborator Number Metric
            

0.3.0 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

0.3.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.3.0 passed this metric

No Binaries Metric
            

0.3.0 passed this metric

Testing File Metric
            

0.3.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.3.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 include a tag that matches this cookbook version number