cookbook 'windows_failover_cluster', '~> 0.3.0'
windows_failover_cluster (3) Versions 0.3.0 Follow1
Install and configure a Windows Failover Cluster Server
cookbook 'windows_failover_cluster', '~> 0.3.0', :supermarket
knife supermarket install windows_failover_cluster
knife supermarket download windows_failover_cluster
windows_failover_cluster
Chef cookbook to install and configure a Windows Failover Cluster Server.
Table of contents
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:
- Fork this repository
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new pull request
License and Author
Authors and contributors:
- Author: Stephen Hoekstra (stephenhoekstra@gmail.com)
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
0.3.0 failed this 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
0.3.0 passed this 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
0.3.0 failed this 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