Added information/command to populate local repository.
Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/730aab8c Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/730aab8c Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/730aab8c Branch: refs/heads/0.5.0 Commit: 730aab8c5eecbf25e36f5f48c1749d60d9e2cd93 Parents: 04ab131 Author: David Toy <[email protected]> Authored: Thu Apr 25 11:54:13 2013 +0100 Committer: David Toy <[email protected]> Committed: Thu Apr 25 12:00:55 2013 +0100 ---------------------------------------------------------------------- docs/dev/tips/local-artifact-repo.md | 32 +++++++++++++++++++++++++++++++ docs/dev/tips/toc.json | 2 ++ 2 files changed, 34 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/730aab8c/docs/dev/tips/local-artifact-repo.md ---------------------------------------------------------------------- diff --git a/docs/dev/tips/local-artifact-repo.md b/docs/dev/tips/local-artifact-repo.md new file mode 100644 index 0000000..4ba824e --- /dev/null +++ b/docs/dev/tips/local-artifact-repo.md @@ -0,0 +1,32 @@ +--- +layout: page +title: Prepopulating a Local Artifact Repository +toc: /toc.json +--- + +On occasion it can be useful to have/control/prepopulate a local repository of entity installers <small>[1]</small>. + +The following command (run from `~/`) may be used to sync Cloudsoft's fallback repository to the local `~/.brooklyn/repository/` folder: + + wget --directory-prefix=".brooklyn/repository/" --no-parent --relative --no-host-directories --reject="index.html*" --cut-dirs=2 --recursive -e robots=off --user-agent="Brooklyn Repository Sync" http://downloads.cloudsoftcorp.com/brooklyn/repository/ + +Brooklyn's default search behaviour for installation artifacts is as follows: + +1. The local `~/.brooklyn/repository/` folder. +2. The entity's installer's public download url (or an overridden url if one has been specified). +3. Cloudsoft's fallback repository. + +Cloudsoft's fallback repository <small>[2]</small> contains many of the installation artifacts used by current Brooklyn entities. + +It is intended to prevent problems occurring when the public url for an installer changes (e.g. when several new versions of MySQL have been released). It is provided on an as-is and as-is-available basis. + +If you use this command to create a local repository, please respect the `--user-agent`. In future this will allow Cloudsoft to easily filter repository syncing behaviour from fallback behaviour, allowing out-of-date entities to be more easily be identified and updated. + +<br /> +<small> +<ol> +<li>For example, when establishing a local cache or enterprise golden source, or when developing Brooklyn while offline, in planes, trains and automobiles, or other such situations of exemplary derring-do <small>[3]</small>.</li> +<li><a href="http://downloads.cloudsoftcorp.com/brooklyn/repository/";>downloads.cloudsoftcorp.com/brooklyn/repository</a></li> +<li>This one time, Cloudsoft ran a team hackathon in a castle in the remote Highlands of Scotland. Remote Highlands != reliable big pipe internet.</li> +</ol> +</small> http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/730aab8c/docs/dev/tips/toc.json ---------------------------------------------------------------------- diff --git a/docs/dev/tips/toc.json b/docs/dev/tips/toc.json index 9d40695..28ea3a5 100644 --- a/docs/dev/tips/toc.json +++ b/docs/dev/tips/toc.json @@ -5,6 +5,8 @@ "file": "{{ site.url }}/dev/tips/logging.html" }, { "title": "Code Standards", "file": "{{ site.url }}/dev/tips/standards.html" }, +{ "title": "Local Artifact Repo", + "file": "{{ site.url }}/dev/tips/local-artifact-repo.html" }, { "title": "Updating Docs", "file": "{{ site.url }}/dev/tips/update-docs.html" } ]
