You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@brooklyn.apache.org by he...@apache.org on 2016/02/01 18:44:26 UTC
[37/50] brooklyn-docs git commit: Added information/command to
populate local repository.
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 <d...@vidtoy.co.uk>
Authored: Thu Apr 25 11:54:13 2013 +0100
Committer: David Toy <d...@vidtoy.co.uk>
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" }
]