Skip to content

Latest commit

 

History

History
86 lines (67 loc) · 2.42 KB

README.md

File metadata and controls

86 lines (67 loc) · 2.42 KB
Raw

A Puppet module to download files with wget, supporting authentication.

Example

install wget:

	   include wget
	   wget::fetch { "download Google's index":
       source      => 'http://www.google.com/index.html',
       destination => '/tmp/index.html',
       timeout     => 0,
       verbose     => false,
	}

or alternatively:

     wget::fetch { 'http://www.google.com/index.html':
       destination => '/tmp/index.html',
       timeout     => 0,
       verbose     => false,
     }

This fetches a document which requires authentication:

     wget::fetch { 'Fetch secret PDF':
        source      => 'https://confidential.example.com/secret.pdf',
        destination => '/tmp/secret.pdf',
        user        => 'user',
        password    => 'p$ssw0rd',
        timeout     => 0,
        verbose     => false,
     }

This caches the downloaded file in an intermediate directory to avoid repeatedly downloading it. This uses the timestamping (-N) and prefix (-P) wget options to only re-download if the source file has been updated.

     wget::fetch { 'https://tool.com/downloads/tool-1.0.tgz':
        destination => '/tmp/tool-1.0.tgz',
        cache_dir   => '/var/cache/wget',
     }

It's assumed that the cached file will be named after the source's URL basename but this assumption can be broken if wget follows some redirects. In this case you must inform the correct filename in the cache like this:

     wget::fetch { 'https://tool.com/downloads/tool-latest.tgz':
        destination => '/tmp/tool-1.0.tgz',
        cache_dir   => '/var/cache/wget',
        cache_file  => 'tool-1.1.tgz',
     }

Testing

rake will run the rspec-puppet specs

rake spec:system will run the rspec-system specs with vagrant

RS_DESTROY=no rake spec:system to avoid destroying the vm after running the tests

License

Copyright 2011-2013 MaestroDev

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.