brooklyn-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From henev...@apache.org
Subject [37/50] brooklyn-docs git commit: Added information/command to populate local repository.
Date Mon, 01 Feb 2016 17:44:26 GMT
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" }
 ]


Mime
View raw message