README.md
Filesystem Resize Cookbook
==========================
[](https://supermarket.chef.io/cookbooks/filesystem_resize)
[](https://gemnasium.com/zuazo/filesystem_resize-cookbook)
[](https://codeclimate.com/github/zuazo/filesystem_resize-cookbook)
[](https://travis-ci.org/zuazo/filesystem_resize-cookbook)
This [Chef](https://www.chef.io/) cookbook resizes the file system automatically when the underlying partition or disk increases its size.
It is mainly oriented to work with cloud or virtual servers where it is common to change the disk size.
Requirements
============
## Platform Requirements
This cookbook has been tested on the following platforms:
* Amazon (>= 2012.03)
* CentOS (>= 6.0)
* Debian (>= 7.0)
* Fedora
* RedHat
* Ubuntu (>= 12.04)
Please, [let us know](https://github.com/zuazo/filesystem_resize-cookbook/issues/new?title=I%20have%20used%20it%20successfully%20on%20...) if you use it successfully on any other platform.
## Application Requirements
* Ruby 1.9.3 or higher.
The other required applications usually come with the operating system:
* `lsblk`, `findmnt` and `losetup`: included inside **[util-linux](http://en.wikipedia.org/wiki/Util-linux) (≥ 2.19)** package.
* `pgrep`: included inside [procps-ng](http://sourceforge.net/projects/procps-ng/) package.
* `e2fsck`, `dumpe2fs` and `resize2fs` for *ext3* and *ext4*: included inside [e2fsprogs](http://e2fsprogs.sourceforge.net/) package.
* `xfs_info` and `xfs_growfs` for *XFS*: included inside [xfsprogs](http://oss.sgi.com/projects/xfs/) package.
Attributes
==========
| Parameter | Default | Description |
|:-------------------------------------------|:--------|:-----------------------------------------|
| `node['filesystem_resize']['compiletime']` | `false` | Resize the file systems at compile time.
Recipes
=======
## filesystem_resize::default
Resizes all mounted file systems.
Resources
=========
## filesystem_resize(device)
Resizes a partition.
### filesystem_resize Actions
* `run` (default)
### filesystem_resize Parameters
| Parameter | Default | Description |
|:----------|:------------------|:-----------------------------------------|
| device | *resource name* | Device full path.
## filesystem_resize_all(name)
Resizes all mounted file systems.
### filesystem_resize Actions
* `run` (default)
Usage
=====
## Including in a Cookbook Recipe
You can simply include it in a recipe:
```ruby
# in your recipe
include_recipe 'filesystem_resize'
```
Don't forget to include the `filesystem_resize` cookbook as a dependency in the metadata:
```ruby
# metadata.rb
depends 'filesystem_resize'
```
## Including in the Run List
Another alternative is to include it in your Run List:
```json
{
"name": "app001.example.com",
[...]
"run_list": [
[...]
"recipe[filesystem_resize]"
]
}
```
Testing
=======
See [TESTING.md](https://github.com/zuazo/filesystem_resize-cookbook/blob/master/TESTING.md).
## ChefSpec Matchers
### filesystem_resize(device)
Helper method for locating a `filesystem_resize` resource in the collection.
```ruby
resource = chef_run.filesystem_resize('/dev/sda1')
expect(resource).to notify('service[apache2]').to(:restart)
```
### run_filesystem_resize(device)
Assert that the Chef Run runs `filesystem_resize`.
```ruby
expect(chef_run).to run_filesystem_resize('/dev/sda1')
```
### filesystem_resize_all(name)
Helper method for locating a `filesystem_resize_all` resource in the collection.
```ruby
resource = chef_run.filesystem_resize_all('default')
expect(resource).to notify('service[apache2]').to(:restart)
```
### run_filesystem_resize_all(name)
Assert that the Chef Run runs `filesystem_resize`.
```ruby
expect(chef_run).to run_filesystem_resize_all('default')
```
Contributing
============
Please do not hesitate to [open an issue](https://github.com/zuazo/filesystem_resize-cookbook/issues/new) with any questions or problems.
See [CONTRIBUTING.md](https://github.com/zuazo/filesystem_resize-cookbook/blob/master/CONTRIBUTING.md).
TODO
====
See [TODO.md](https://github.com/zuazo/filesystem_resize-cookbook/blob/master/TODO.md).
License and Author
==================
| | |
|:---------------------|:-----------------------------------------|
| **Author:** | [Xabier de Zuazo](https://github.com/zuazo) (<xabier@zuazo.org>)
| **Copyright:** | Copyright (c) 2015, Xabier de Zuazo
| **Copyright:** | Copyright (c) 2014-2015, Onddo Labs, SL.
| **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.