You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@brooklyn.apache.org by ri...@apache.org on 2017/02/10 17:04:26 UTC
svn commit: r1782490 [3/4] - in /brooklyn/site: ./ community/
community/security/ contributing/ developers/ developers/code/
developers/committers/ developers/committers/release-process/
documentation/ download/ learnmore/ learnmore/catalog/ learnmore/...
Added: brooklyn/site/developers/committers/release-process/prepare-for-release.html
URL: http://svn.apache.org/viewvc/brooklyn/site/developers/committers/release-process/prepare-for-release.html?rev=1782490&view=auto
==============================================================================
--- brooklyn/site/developers/committers/release-process/prepare-for-release.html (added)
+++ brooklyn/site/developers/committers/release-process/prepare-for-release.html Fri Feb 10 17:04:25 2017
@@ -0,0 +1,777 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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.
+-->
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+
+
+<head>
+
+
+<title>Prepare the project for a release - Apache Brooklyn</title>
+
+<meta http-equiv="content-type" content="text/html; charset=utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+
+<link href="https://netdna.bootstrapcdn.com/bootstrap/3.1.1/css/bootstrap.min.css" rel="stylesheet">
+<link href="/style/deps/octicons/octicons.css" rel="stylesheet">
+<link href="/style/deps/bootstrap-theme.css" rel="stylesheet">
+
+<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
+<script src="https://netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js"></script>
+<script type="text/javascript" src="/style/deps/jquery.cookie.js"></script>
+
+
+
+<link rel="stylesheet" href="/style/css/code.css" type="text/css" media="screen" />
+<link href="/style/css/website.css" rel="stylesheet">
+
+
+
+</head>
+
+
+<body>
+
+<nav class="navbar navbar-default navbar-fixed-top" id="header" role="navigation">
+ <div class="container-and-sidebars">
+
+ <div class="container-sidebar-left feather">
+ <a href="http://www.apache.org/">
+ <img src="/style/img/feather.png" alt="[Apache]" width="80" class="flip navbar-feather">
+ </a>
+ </div>
+
+ <div class="container container-between-sidebars top-menu">
+ <div class="container-fluid">
+ <!-- Brand and toggle get grouped for better mobile display -->
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/"><img src="/style/img/apache-brooklyn-logo-244px-wide.png" alt="brooklyn"></a>
+ </div>
+
+ <!-- Collect the nav links, forms, and other content for toggling -->
+ <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+ <ul class="nav navbar-nav navbar-right">
+
+
+ <li class="dropdown">
+ <a href="/learnmore/index.html">learn more</a>
+ <ul class="dropdown-menu" role="menu">
+ <li>
+ <a href="/learnmore/index.html">Learn More</a>
+ </li>
+ <li class="divider"></li>
+
+ <li>
+
+ <a href="/learnmore/blueprint-tour.html">Blueprint Tour
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/learnmore/features/index.html">Features
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/learnmore/theory.html">Theory
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/learnmore/catalog/index.html">Browse Catalog
+ </a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="">
+ <a href="/download/index.html">download</a>
+ </li>
+
+
+
+ <li class="dropdown">
+ <a href="/v/latest/start/index.html">get started</a>
+ <ul class="dropdown-menu" role="menu">
+ <li>
+ <a href="/v/latest/start/index.html">Get Started</a>
+ </li>
+ <li class="divider"></li>
+
+ <li>
+
+ <a href="/v/latest/start/running.html">Running Apache Brooklyn
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/v/latest/start/blueprints.html">Deploying Blueprints
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/v/latest/start/managing.html">Monitoring and Managing Applications
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/v/latest/start/policies.html">Policies
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/v/latest/start/concept-quickstart.html">Brooklyn Concepts Quickstart
+ </a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="dropdown">
+ <a href="/documentation/index.html">documentation</a>
+ <ul class="dropdown-menu" role="menu">
+ <li>
+ <a href="/documentation/index.html">Documentation</a>
+ </li>
+ <li class="divider"></li>
+
+ <li>
+
+ <a href="/v/latest/index.html">User Guide
+ </a>
+
+ <div class="dropdown_section_header"><hr></div>
+
+ </li>
+
+ <li>
+
+ <a href="/v/latest/yaml/creating-yaml.html">YAML Blueprints
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/v/latest/java/index.html">Java Blueprints
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/v/latest/ops/index.html">Operations
+ </a>
+
+ <div class="dropdown_section_header"><hr></div>
+
+ </li>
+
+ <li>
+
+ <a href="/v/latest/dev/index.html">Developer Guide
+ </a>
+
+ </li>
+
+ <li>
+
+ <div class="dropdown_new_section"><hr></div>
+
+ <a href="/meta/versions.html">Versions
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/documentation/other-docs.html">Other Resources
+ </a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="dropdown">
+ <a href="/community/index.html">community</a>
+ <ul class="dropdown-menu" role="menu">
+ <li>
+ <a href="/community/index.html">Community</a>
+ </li>
+ <li class="divider"></li>
+
+ <li>
+
+ <a href="/community/mailing-lists.html">Mailing Lists
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/community/irc.html">IRC
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
+ <span class="octicon octicon-link-external"></span></a>
+
+ </li>
+
+ <li>
+
+ <a href="/community/how-to-contribute-docs.html">Contributing Documentation
+ </a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+
+ <li class="dropdown">
+ <a href="/developers/index.html">developers</a>
+ <ul class="dropdown-menu" role="menu">
+ <li>
+ <a href="/developers/index.html">Developers</a>
+ </li>
+ <li class="divider"></li>
+
+ <li>
+
+ <a href="/developers/code/index.html">Get the Code
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/developers/how-to-contribute.html">How to Contribute
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/v/latest/dev/index.html">Developer Guide
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/developers/committers/index.html">Committer Guide
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/developers/code-standards.html">Code Standards
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="/developers/links.html">Handy Places
+ </a>
+
+ </li>
+
+ <li>
+
+ <a href="http://github.com/apache/brooklyn">GitHub
+ <span class="octicon octicon-link-external"></span></a>
+
+ </li>
+
+ <li>
+
+ <a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
+ <span class="octicon octicon-link-external"></span></a>
+
+ </li>
+
+ </ul>
+ </li>
+
+
+ </ul>
+ </div><!-- /.navbar-collapse -->
+ </div><!-- /.container-fluid -->
+ </div><!-- /.container -->
+
+ <div class="container-sidebar-right">
+ <div class="navbar-sidebar-right-icons">
+ <a href="https://github.com/apache/brooklyn" class="navbar-icon navbar-icon-shift icon-github"
+ data-toggle="tooltip" data-placement="bottom" title="GitHub: apache/brooklyn"/>
+ <a href="https://twitter.com/#!/search?q=brooklyncentral" class="navbar-icon navbar-icon-shift icon-twitter"
+ data-toggle="tooltip" data-placement="bottom" title="Twitter: @brooklyncentral"/>
+ <a href="http://webchat.freenode.net/?channels=brooklyncentral" class="navbar-icon icon-irc"
+ data-toggle="tooltip" data-placement="bottom" title="IRC: freenode #brooklyncentral"/>
+ <!-- extra a element seems needed as landing page seems to copy the last element here (!?)
+ -->
+ <a href="/" style="width: 0px; height: 0px;"></a>
+ </div>
+ </div>
+
+ </div>
+</nav>
+
+
+<div class="container" id="main_container">
+ <div class="row">
+ <div class="col-md-9" id="content_container">
+ <div id="page_notes"></div>
+ <h1>Prepare the project for a release</h1>
+ <ol>
+ <li>Make sure all unit and integration tests are passing.</li>
+ <li>Follow the <a href="https://github.com/apache/brooklyn-dist/blob/master/dist/licensing/README.md#update-license-information">classic</a>
+and <a href="https://github.com/apache/brooklyn-dist/pull/63">karaf</a> instructions to
+update the licenses of source and binary dependencies. </li>
+ <li>Update the <a href="https://github.com/apache/brooklyn-docs/blob/master/guide/misc/release-notes.md">release notes</a>. To help
+in the process <a href="https://gist.github.com/sjcorbett/72ed944b06ce3a138fbe516e8d36f624">list merged PRs</a> after a ceratin date.</li>
+</ol>
+
+ </div>
+
+ <div class="col-md-3">
+ <div class="list-group side-menu" id="side-menu">
+
+
+
+
+
+
+
+
+
+
+
+
+</div>
+<div id="width_reference"></div>
+
+
+<script language="JavaScript" type="application/javascript">
+
+
+sidemenu_x_sizer=function(){ $('#side-menu').width($('#side-menu').parent().find('#width_reference').outerWidth()); };
+$(sidemenu_x_sizer);
+$(window).resize(sidemenu_x_sizer);
+
+
+sidemenu_y_nonfloater=function(){
+ if ($('#side-menu').outerHeight(true) + $('#header').outerHeight(true) + $('#footer').outerHeight(true) > window.innerHeight ||
+ $('#side-menu').width() >= $('#content_container').width()/2) {
+ $('#side-menu').css('position', 'inherit');
+ } else {
+ // restore if screen has grown
+ $('#side-menu').css('position', 'fixed');
+ }
+};
+$(sidemenu_y_nonfloater);
+$(window).resize(sidemenu_y_nonfloater);
+
+
+
+var sideMenu = $("#side-menu"),
+ sideItems = sideMenu.find("a"),
+ // Anchors corresponding to menu items
+ scrollItems = sideItems.map(function(){
+ var item = $(this).attr("section-target");
+ if (item && item.length) { return item; }
+ });
+
+var highlight_section_last_top = -1;
+var highlight_section_completed = false;
+
+var highlight_section = function() {
+ // Get container scroll position
+ var highlight_section_new_top = $(this).scrollTop();
+ if (highlight_section_new_top == highlight_section_last_top) return;
+ var highlight_section_new_bottom = highlight_section_new_top + $(window).height();
+ var scroll_advancing = (highlight_section_new_top > highlight_section_last_top);
+
+ var last_item = null, active_item = $("#side-menu a.section#active");
+
+ var found_top = false;
+ var displayable_items = scrollItems.map(function(itemI){
+ item = $(scrollItems[itemI]);
+ if (item && item.length) {
+ if (highlight_section_last_top == -1 || !highlight_section_completed) {
+ // just opening page - take item matching hash, or otherwise the first item visible
+ if (item.selector === window.location.hash || (item.offset().top > highlight_section_new_top - 20 && !found_top)) {
+ found_top = true;
+ if (item.selector === window.location.hash && item.offset().top < highlight_section_new_top + 60) {
+ // because of our top header, we need to scroll 64px down from any link
+ $('html, body').animate({scrollTop: item.offset().top - 64}, 0);
+ }
+ return item;
+ }
+ } else if (scroll_advancing) {
+ // if scrolling advance, pick up a section when title starts before 1/3 height
+ if (item.offset().top < highlight_section_new_top + $(window).height()/3)
+ return item;
+
+ // or if containing div is finished (usu the whole main content)
+ div_containing_item = item.closest("div");
+ if (div_containing_item.offset().top + div_containing_item.height() < highlight_section_new_bottom + 15)
+ return item;
+ // or when next title is visible
+ if (last_item && item.offset().top < highlight_section_new_bottom + 15)
+ return last_item;
+ } else {
+ // if scrolling back, pick up a section as soon as the title is visible,
+ if (item.offset().top < highlight_section_new_top)
+ return item;
+ // or if title is before the 2/3 point
+ // (not sure about this, probably want also to have
+ // "AND the id.top is <= displayable_itemsrent_active_it.top" so we don't jump FORWARD a section
+ // when scrolling BACK, with lots of tiny sections)
+ if ((item.offset().top < highlight_section_new_top + 2*$(window).height()/3)
+ && (!active_item || !active_item.offset() || active_item.offset().top >= item.offset().top))
+ return item;
+
+ }
+ last_item = item;
+ }
+ });
+ if (!highlight_section_completed && document.readyState === "complete") {
+ highlight_section_completed = true;
+ }
+ if (!displayable_items.length) {
+ $("#side-menu a.section").removeClass("active");
+ } else {
+ displayable_items = displayable_items[displayable_items.length-1];
+ var id = displayable_items && displayable_items.length ? displayable_items[0].id : "";
+ // Set/remove active class
+ new_active = $("#side-menu a.section").filter("[section-target='#"+id+"']");
+ if (new_active.hasClass("active")) {
+ // nothing needed
+ } else {
+ $("#side-menu a.section").removeClass("active");
+ $("#side-menu a.section").filter("[section-target='#"+id+"']").addClass("active");
+ }
+ }
+
+ highlight_section_last_top = highlight_section_new_top;
+};
+var highlight_new_section = function() {
+ highlight_section_completed = false;
+ highlight_section_last_top = -1;
+ highlight_section();
+}
+
+$(window).scroll(highlight_section);
+$(highlight_new_section);
+
+// detect link change - courtesy http://www.bennadel.com/blog/1520-binding-events-to-non-dom-objects-with-jquery.htm
+ (
+ function( $ ){
+ // Default to the current location.
+ var strLocation = window.location.href;
+ var strHash = window.location.hash;
+ var strPrevLocation = "";
+ var strPrevHash = "";
+
+ // This is how often we will be checkint for
+ // changes on the location.
+ var intIntervalTime = 100;
+
+ // This method removes the pound from the hash.
+ var fnCleanHash = function( strHash ){
+ return(
+ strHash.substring( 1, strHash.length )
+ );
+ }
+
+ // This will be the method that we use to check
+ // changes in the window location.
+ var fnCheckLocation = function(){
+ // Check to see if the location has changed.
+ if (strLocation != window.location.href){
+
+ // Store the new and previous locations.
+ strPrevLocation = strLocation;
+ strPrevHash = strHash;
+ strLocation = window.location.href;
+ strHash = window.location.hash;
+
+ // The location has changed. Trigger a
+ // change event on the location object,
+ // passing in the current and previous
+ // location values.
+ $( window.location ).trigger(
+ "change",
+ {
+ currentHref: strLocation,
+ currentHash: fnCleanHash( strHash ),
+ previousHref: strPrevLocation,
+ previousHash: fnCleanHash( strPrevHash )
+ }
+ );
+
+ }
+ }
+
+ // Set an interval to check the location changes.
+ setInterval( fnCheckLocation, intIntervalTime );
+ }
+ )( jQuery );
+// and trigger highlight section on link change
+$(window.location).bind("change", highlight_new_section);
+
+</script>
+
+ </div>
+ </div>
+</div>
+
+<div id="footer">
+ <div class="container">
+ <div class="row">
+ <div class="col-md-10 text-muted">
+ Apache Brooklyn is distributed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License v2.0</a>.
+ </div>
+ <div class="col-md-2">
+ <a class="btn btn-sm btn-default" href="https://github.com/apache/brooklyn-docs/edit/master/website/developers/committers/release-process/prepare-for-release.md">Edit This Page</a>
+ <a href="https://brooklyn.apache.org/community/how-to-contribute-docs.html"
+ data-toggle="tooltip" data-placement="top" title="How to Edit Documentation" data-delay="400"/>
+ <span class="octicon octicon-question octicon-footer"></span>
+ </a>
+ </div>
+ </div>
+ </div>
+</div>
+
+
+
+
+<script language="JavaScript" type="application/javascript">
+
+ fix_padding_function = function () {
+ $('body').css('padding-top', parseInt($('#header').css("height"))+10);
+ $('body').css('padding-bottom', parseInt($('#footer').css("height"))+10);
+ };
+ $(window).resize(fix_padding_function);
+ $(window).load(fix_padding_function);
+
+ $(function () {
+ $('[data-toggle="tooltip"]').tooltip({ delay: { show: 600, hide: 100 }})
+ });
+
+/* generate anchors for headers, a la github and http://blog.parkermoore.de/2014/08/01/header-anchor-links-in-vanilla-javascript-for-github-pages-and-jekyll/ */
+var anchorForId = function (id, text) {
+ var anchor = document.createElement("a");
+ anchor.className = "header-link";
+ anchor.href = "#" + id;
+ anchor.innerHTML = "<i class=\"fa fa-link\"></i>";
+ return anchor;
+};
+
+var linkifyAnchors = function (level, containingElement) {
+ var headers = contentBlock.find("h" + level);
+ for (var h = 0; h < headers.length; h++) {
+ var header = headers[h];
+ if (typeof header.id !== "undefined" && header.id !== "") {
+ header.appendChild(anchorForId(header.id, $(header).text()));
+ }
+ }
+};
+
+$(function () {
+ contentBlock = $("#content_container");
+ if (!contentBlock) return;
+ for (var level = 1; level <= 6; level++) {
+ linkifyAnchors(level, contentBlock);
+ }
+});
+
+<!-- Copying and clipboard support -->
+
+// first make the $% line starts not selectable
+
+$(function() {
+ $('div.highlight').attr('oncopy', 'handleHideCopy(this)');
+ $('div.highlight').each(function(index,target) {
+ if ($(target).find('code.bash')) {
+ // Mark bash prompts from the start of each line (i.e. '$' or '%' characters
+ // at the very start, or immediately following any newline) as not-selectable.
+ // Handle continuation lines where a leading '$' or '%' is *not* a prompt character.
+ // (If example wants to exclude output, it can manually use class="nocopy".)
+ target.innerHTML = target.innerHTML.replace(/(^\s*|[^\\]\n)(<.*>)?([$%]|>) /g, '$1$2<span class="nocopy bash_prompt">$3 </span>');
+ }
+ });
+});
+
+// normal cmd-C (non-icon) copying
+
+function handleHideCopy(el) {
+// var origHtml = $(el).clone();
+ console.log("handling copy", el);
+ $(el).addClass('copying');
+ $(el).find('.nocopy').hide();
+ $(el).find('.clipboard_button').addClass('manual-clipboard-is-active');
+ setTimeout(function(){
+ $(el).removeClass('copying');
+ $(el).find('.clipboard_button').removeClass('manual-clipboard-is-active');
+ $(el).find('.nocopy').show();
+// $(el).html(origHtml);
+ }, 600);
+}
+
+// and icon (flash) copying
+
+</script>
+
+<script src="/style/js/zeroclipboard/ZeroClipboard.min.js"></script>
+
+<script language="JavaScript" type="application/javascript">
+
+ZeroClipboard.config({ moviePath: '/style/js/zeroclipboard/ZeroClipboard.swf' });
+
+$(function() {
+ $('div.highlight').prepend(
+ $('<div class="clipboard_container" title="Copy to Clipboard">'+
+ '<div class="fa clipboard_button">'+
+ '<div class="on-active"><div>Copied to Clipboard</div></div>'+
+ '</div></div>'));
+ $('div.clipboard_container').each(function(index) {
+ var clipboard = new ZeroClipboard();
+ clipboard.clip( $(this).find(":first")[0], $(this)[0] );
+ var target0 = $(this).next();
+ var target = target0.clone();
+ target.find('.nocopy').remove();
+ var txt = target.text();
+ clipboard.on( 'dataRequested', function (client, args) {
+ handleHideCopy( target0.closest('div.highlight') ); //not necessary but nicer feedback
+ client.setText( txt );
+ });
+ });
+});
+
+
+<!-- search -->
+ $(function() {
+ $('#simple_google')
+ .submit(function() {
+ $('input[name="q"]').val("site:" + document.location.hostname + " " + $('input[name="brooklyn-search"]').val());
+ return true;
+ });
+ $('input[name="brooklyn-search"]').focus(function() {
+ if ($(this).val() === $(this).attr('placeholder')) {
+ $(this).val('');
+ }
+ })
+ .blur(function() {
+ if ($(this).val() === '') {
+ $(this).val($(this).attr('placeholder'));
+ }
+ })
+ .blur();
+ });
+
+
+ <!-- analytics -->
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-30530918-1']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+
+
+<!-- page warning (for archive pages) -->
+
+
+ function get_user_versions() {
+ return $.cookie("brooklyn_versions") ? $.cookie("brooklyn_versions").split(",") : [];
+ };
+ function set_user_version(version) {
+ var version_cookie = get_user_versions();
+ version_cookie.push(version);
+ $.cookie('brooklyn_versions', version_cookie, { expires: 365, path: '/' });
+ $('#page_notes').fadeOut();
+ event.preventDefault ? event.preventDefault() : event.returnValue = false;
+ };
+ function set_user_versions_all() {
+ var version_cookie = get_user_versions();
+ version_cookie.push("ALL");
+ $.cookie('brooklyn_versions', version_cookie, { expires: 365, path: '/' });
+ $('#page_notes').fadeOut();
+ event.preventDefault ? event.preventDefault() : event.returnValue = false;
+ };
+ function clear_user_versions() {
+ $.removeCookie('brooklyn_versions', { path: '/' });
+ $('#page_notes').fadeIn('slow');
+ event.preventDefault ? event.preventDefault() : event.returnValue = false;
+ };
+
+</script>
+
+</body>
+
+</html>
Modified: brooklyn/site/developers/committers/release-process/prerequisites.html
URL: http://svn.apache.org/viewvc/brooklyn/site/developers/committers/release-process/prerequisites.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/developers/committers/release-process/prerequisites.html (original)
+++ brooklyn/site/developers/committers/release-process/prerequisites.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
@@ -426,8 +433,9 @@ recommended; building on a mac, <code>po
(with a <code>gpg</code> alias). The steps here also assume you have the following set
(not using <code>whoami</code> if that’s not appropriate):</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nv">GPG_KEY</span><span class="o">=</span><span class="sb">`</span>whoami<span class="sb">`</span>@apache.org
-<span class="nv">SVN_USERNAME</span><span class="o">=</span><span class="sb">`</span>whoami<span class="sb">`</span></code></pre></div>
+<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nv">ASF_USERNAME</span><span class="o">=</span><span class="sb">`</span>whoami<span class="sb">`</span>
+<span class="nv">GPG_KEY</span><span class="o">=</span><span class="nv">$ASF_USERNAME</span>@apache.org
+<span class="nv">SVN_USERNAME</span><span class="o">=</span><span class="nv">$ASF_USERNAME</span></code></pre></div>
<p>If you have an existing GPG key, but it does not include your Apache email address, you can add your email address as
described <a href="https://superuser.com/a/293283">in this Superuser.com posting</a>. Otherwise, create a new GPG key giving your
@@ -444,8 +452,8 @@ separated by spaces. Log in to <a href="
<p>Now add your key to the <code>apache-dist-release-brooklyn/KEYS</code> file:</p>
<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd </span>apache-dist-release-brooklyn
-<span class="o">(</span>gpg2 --list-sigs richard@apache.org <span class="o">&&</span> gpg2 --armor --export richard@apache.org<span class="o">)</span> >> KEYS
-svn --username <span class="nv">$SVN_USERNAME</span> commit -m <span class="s1">'Update brooklyn/KEYS for $GPG_KEY'</span></code></pre></div>
+<span class="o">(</span>gpg2 --list-sigs <span class="nv">$ASF_USERNAME</span>@apache.org <span class="o">&&</span> gpg2 --armor --export <span class="nv">$ASF_USERNAME</span>@apache.org<span class="o">)</span> >> KEYS
+svn --username <span class="nv">$SVN_USERNAME</span> --no-auth-cache commit -m <span class="s2">"Update brooklyn/KEYS for $GPG_KEY"</span></code></pre></div>
<p>References:</p>
Modified: brooklyn/site/developers/committers/release-process/publish-temp.html
URL: http://svn.apache.org/viewvc/brooklyn/site/developers/committers/release-process/publish-temp.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/developers/committers/release-process/publish-temp.html (original)
+++ brooklyn/site/developers/committers/release-process/publish-temp.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
@@ -400,7 +407,7 @@ information.</p>
and all associated <code>.md5</code>, <code>.sha1</code>, <code>.sha256</code> and <code>.asc</code> signatures. Then commit:</p>
<div class="highlight"><pre><code class="language-bash" data-lang="bash">svn add apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span>-rc<span class="k">${</span><span class="nv">RC_NUMBER</span><span class="k">}</span>
-svn commit --message <span class="s2">"Add apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER} to dist/dev/brooklyn"</span></code></pre></div>
+svn commit --username <span class="nv">$SVN_USERNAME</span> --no-auth-cache --message <span class="s2">"Add apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER} to dist/dev/brooklyn"</span></code></pre></div>
<p>These steps can be performed as part of the <code>make-release-artifacts.sh</code> script used earlier
if <code>${APACHE_DIST_SVN_DIR}</code> points to the appropriate subversion directory.</p>
@@ -413,7 +420,7 @@ be used for downloading the artifacts.</
<p>Go to the Apache Nexus server at <a href="https://repository.apache.org/">https://repository.apache.org/</a> and log in using the
link in the top right (the credentials are the same as your Git and Jenkins credentials). Go to the “Staging
Repositories” page, and tick the repository with the name starting <code>orgapachebrooklyn</code>. Click the <strong>Close</strong> button.
-Provide a description which includes the version and release candidate, e.g. <code>Apache Brooklyn 0.7.0-incubating-rc1</code>.</p>
+Provide a description which includes the version and release candidate, e.g. <code>Apache Brooklyn 0.10.0-rc1</code>.</p>
</div>
Modified: brooklyn/site/developers/committers/release-process/publish.html
URL: http://svn.apache.org/viewvc/brooklyn/site/developers/committers/release-process/publish.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/developers/committers/release-process/publish.html (original)
+++ brooklyn/site/developers/committers/release-process/publish.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
@@ -400,10 +407,9 @@ information.</p>
the release candidate artifacts - <code>-src</code> and <code>-bin</code>, <code>.tar.gz</code> and <code>.zip</code>, and all associated <code>.md5</code>, <code>.sha1</code>, <code>.sha256</code>
and <code>.asc</code> signatures - into this new folder.</p>
-<p>Rename all of the files to remove the <code>-rcN</code> designation. If you have the <code>mmv</code> tool installed, this can be done with
-this command:</p>
+<p>Rename all of the files to remove the <code>-rcN</code> designation:</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">mmv -v <span class="s1">'*-rc'</span><span class="nv">$RC_NUMBER</span><span class="s1">'-*'</span> <span class="s1">'#1-#2'</span></code></pre></div>
+<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> f in *<span class="p">;</span> <span class="k">do</span> mv <span class="nv">$f</span> <span class="k">${</span><span class="nv">f</span><span class="p">//-rc</span><span class="k">${</span><span class="nv">RC_NUMBER</span><span class="k">}</span><span class="p">/</span><span class="k">}</span><span class="p">;</span> <span class="k">done</span></code></pre></div>
<p>The hash files will need patching to refer to the filenames without the <code>-rcN</code> designation:</p>
@@ -414,11 +420,12 @@ rm -f *.bak</code></pre></div>
<p>As a final check, re-test the hashes and signatures:</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> artifact in *.tar.gz *.zip *.rpm<span class="p">;</span> <span class="k">do</span>
- md5sum -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.md5
- shasum -a1 -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha1
- shasum -a256 -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha256
- gpg2 --verify <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.asc <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>
+<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> artifact in <span class="k">$(</span>find * -type f ! <span class="se">\(</span> -name <span class="s1">'*.asc'</span> -o -name <span class="s1">'*.md5'</span> -o -name <span class="s1">'*.sha1'</span> -o -name <span class="s1">'*.sha256'</span> <span class="se">\)</span> <span class="k">)</span><span class="p">;</span> <span class="k">do</span>
+ md5sum -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.md5 <span class="o">&&</span> <span class="se">\</span>
+ shasum -a1 -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha1 <span class="o">&&</span> <span class="se">\</span>
+ shasum -a256 -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha256 <span class="o">&&</span> <span class="se">\</span>
+ gpg2 --verify <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.asc <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span> <span class="se">\</span>
+ <span class="o">||</span> <span class="o">{</span> <span class="nb">echo</span> <span class="s2">"Invalid signature for $artifact. Aborting!"</span><span class="p">;</span> <span class="nb">break</span><span class="p">;</span> <span class="o">}</span>
<span class="k">done</span></code></pre></div>
<p>(You may get warnings such as: <code>gpg: WARNING: This key is not certified with a trusted signature!</code>
Modified: brooklyn/site/developers/committers/release-process/release-version.html
URL: http://svn.apache.org/viewvc/brooklyn/site/developers/committers/release-process/release-version.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/developers/committers/release-process/release-version.html (original)
+++ brooklyn/site/developers/committers/release-process/release-version.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
@@ -411,7 +418,7 @@ git add . <span class="o">&&</sp
<p>If you are happy with the changes, push them:</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> m in <span class="nv">$MODULES</span><span class="p">;</span> <span class="k">do</span> <span class="o">(</span> <span class="nb">cd</span> <span class="nv">$m</span> <span class="o">&&</span> git push apache-git <span class="nv">$VERSION</span> <span class="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></div>
+<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> m in <span class="nv">$MODULES</span><span class="p">;</span> <span class="k">do</span> <span class="o">(</span> <span class="nb">cd</span> <span class="nv">$m</span> <span class="o">&&</span> git push apache-git <span class="nv">$VERSION_NAME</span> <span class="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></div>
<h2 id="update-the-version-on-master">Update the version on master</h2>
Modified: brooklyn/site/developers/committers/release-process/verify-release-artifacts.html
URL: http://svn.apache.org/viewvc/brooklyn/site/developers/committers/release-process/verify-release-artifacts.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/developers/committers/release-process/verify-release-artifacts.html (original)
+++ brooklyn/site/developers/committers/release-process/verify-release-artifacts.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
@@ -387,7 +394,7 @@ they have the GnuPG and md5sum/sha1sum i
release. You should determine the following information and set your environment:</p>
<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="c"># The version we are releasing now.</span>
-<span class="nv">VERSION_NAME</span><span class="o">=</span>0.9.0
+<span class="nv">VERSION_NAME</span><span class="o">=</span>0.10.0
<span class="c"># The release candidate number we are making now.</span>
<span class="nv">RC_NUMBER</span><span class="o">=</span>1
@@ -410,30 +417,58 @@ release. You should determine the follow
<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nv">TEMP_DIR</span><span class="o">=</span>~/tmp/brooklyn/release/<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span>-rc<span class="k">${</span><span class="nv">RC_NUMBER</span><span class="k">}</span>
<span class="nv">BASE_NAME</span><span class="o">=</span>apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span>-rc<span class="k">${</span><span class="nv">RC_NUMBER</span><span class="k">}</span>
-<span class="nv">BASE_URL</span><span class="o">=</span>https://dist.apache.org/repos/dist/dev/brooklyn/<span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}</span>
+<span class="nv">BASE_URL</span><span class="o">=</span>https://dist.apache.org/repos/dist/dev/brooklyn/<span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}</span>/
mkdir -p <span class="k">${</span><span class="nv">TEMP_DIR</span><span class="k">}</span>
<span class="nb">cd</span> <span class="k">${</span><span class="nv">TEMP_DIR</span><span class="k">}</span>
-<span class="k">for</span> ext in -src.tar.gz -src.zip -bin.tar.gz -bin.zip<span class="p">;</span> <span class="k">do</span>
- <span class="nv">artifact</span><span class="o">=</span><span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}${</span><span class="nv">ext</span><span class="k">}</span>
- <span class="k">for</span> i in <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span> <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.asc <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.md5 <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha1 <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha256<span class="p">;</span> <span class="k">do</span>
- curl <span class="k">${</span><span class="nv">BASE_URL</span><span class="k">}</span>/<span class="nv">$i</span> -O
- <span class="k">done</span>
-<span class="k">done</span></code></pre></div>
+curl -s <span class="nv">$BASE_URL</span> <span class="p">|</span> <span class="se">\</span>
+ grep href <span class="p">|</span> grep -v <span class="s1">'\.\.'</span> <span class="p">|</span> <span class="se">\</span>
+ sed -e <span class="s1">'s@.*href="@'</span><span class="nv">$BASE_URL</span><span class="s1">'@'</span> <span class="p">|</span> <span class="se">\</span>
+ sed -e <span class="s1">'s@">.*@@'</span> <span class="p">|</span> <span class="se">\</span>
+ xargs -n <span class="m">1</span> curl -O</code></pre></div>
<p>(Alternatively if you have <code>apache-dist-dev-repo</code> checked out,
you can do an <code>svn up</code> in there and <code>cd apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER}</code>.)</p>
+<h2 id="verify-presence-of-notice--license">Verify presence of NOTICE & LICENSE</h2>
+<p>Check that all archives are correctly annotated with license information.
+Check NOTICE is included:</p>
+
+<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> ARCHIVE in <span class="k">$(</span>find * -type f ! <span class="se">\(</span> -name <span class="s1">'*.asc'</span> -o -name <span class="s1">'*.md5'</span> -o -name <span class="s1">'*.sha1'</span> -o -name <span class="s1">'*.sha256'</span> <span class="se">\)</span> <span class="k">)</span><span class="p">;</span> <span class="k">do</span>
+ <span class="nv">REL_ARCHIVE</span><span class="o">=</span><span class="k">${</span><span class="nv">ARCHIVE</span><span class="p">/-rc?</span><span class="k">}</span>
+ <span class="k">case</span> <span class="nv">$ARCHIVE</span> in
+ *.tar.gz<span class="o">)</span>
+ <span class="nv">LIST</span><span class="o">=</span><span class="s2">"tar -tvf"</span>
+ <span class="nv">PREFIX</span><span class="o">=</span><span class="k">${</span><span class="nv">REL_ARCHIVE</span><span class="p">%.tar.gz</span><span class="k">}</span>
+ <span class="p">;;</span>
+ *.zip<span class="o">)</span>
+ <span class="nv">LIST</span><span class="o">=</span><span class="s2">"unzip -Zl"</span>
+ <span class="nv">PREFIX</span><span class="o">=</span><span class="k">${</span><span class="nv">REL_ARCHIVE</span><span class="p">%.zip</span><span class="k">}</span>
+ <span class="p">;;</span>
+ *.rpm<span class="o">)</span>
+ <span class="nv">LIST</span><span class="o">=</span><span class="s2">"rpm -qlp"</span>
+ <span class="nv">PREFIX</span><span class="o">=</span><span class="s2">"/opt/brooklyn"</span>
+ <span class="p">;;</span>
+ *<span class="o">)</span>
+ <span class="nb">echo</span> <span class="s2">"Unrecognized file type $ARCHIVE. Aborting!"</span>
+ <span class="nb">exit </span>1
+ <span class="p">;;</span>
+ <span class="k">esac</span>
+ <span class="nv">$LIST</span> <span class="nv">$ARCHIVE</span> <span class="p">|</span> grep <span class="s2">"$PREFIX/NOTICE"</span> <span class="o">&&</span> <span class="se">\</span>
+ <span class="nv">$LIST</span> <span class="nv">$ARCHIVE</span> <span class="p">|</span> grep <span class="s2">"$PREFIX/LICENSE"</span> <span class="se">\</span>
+ <span class="o">||</span> <span class="o">{</span> <span class="nb">echo</span> <span class="s2">"Missing LICENSE or NOTICE in $ARCHIVE. Aborting!"</span><span class="p">;</span> <span class="nb">break</span><span class="p">;</span> <span class="o">}</span>
+<span class="k">done</span></code></pre></div>
+
<h2 id="verify-the-hashes-and-signatures-of-artifacts">Verify the hashes and signatures of artifacts</h2>
<p>Then check the hashes and signatures, ensuring you get a positive message from each one:</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> ext in -src.tar.gz -src.zip -bin.tar.gz -bin.zip<span class="p">;</span> <span class="k">do</span>
- <span class="nv">artifact</span><span class="o">=</span>apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span>-rc<span class="k">${</span><span class="nv">RC_NUMBER</span><span class="k">}${</span><span class="nv">ext</span><span class="k">}</span>
- md5sum -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.md5
- shasum -a1 -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha1
- shasum -a256 -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha256
- gpg2 --verify <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.asc <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>
+<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> artifact in <span class="k">$(</span>find * -type f ! <span class="se">\(</span> -name <span class="s1">'*.asc'</span> -o -name <span class="s1">'*.md5'</span> -o -name <span class="s1">'*.sha1'</span> -o -name <span class="s1">'*.sha256'</span> <span class="se">\)</span> <span class="k">)</span><span class="p">;</span> <span class="k">do</span>
+ md5sum -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.md5 <span class="o">&&</span> <span class="se">\</span>
+ shasum -a1 -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha1 <span class="o">&&</span> <span class="se">\</span>
+ shasum -a256 -c <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha256 <span class="o">&&</span> <span class="se">\</span>
+ gpg2 --verify <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.asc <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span> <span class="se">\</span>
+ <span class="o">||</span> <span class="o">{</span> <span class="nb">echo</span> <span class="s2">"Invalid signature for $artifact. Aborting!"</span><span class="p">;</span> <span class="nb">break</span><span class="p">;</span> <span class="o">}</span>
<span class="k">done</span></code></pre></div>
<h2 id="verify-expanded-source-archive-matches-contents-of-rc-tag">Verify expanded source archive matches contents of RC tag</h2>
@@ -456,6 +491,17 @@ unzip <span class="k">${</span><span cla
<span class="c"># (or preferably both!)</span>
diff -qr unpacked-src/<span class="nv">$BASE_NAME</span> <span class="nv">$BASE_REPO</span></code></pre></div>
+<h2 id="check-for-files-with-invalid-headers-in-source-archive">Check for files with invalid headers in source archive</h2>
+
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">grep -rL <span class="s2">"Licensed to the Apache Software Foundation"</span> * <span class="p">|</span> less</code></pre></div>
+
+<h2 id="check-for-binary-files-in-source-archive">Check for binary files in source archive</h2>
+
+<p>Look for files which are created/compiled based on other source files in the distribution.
+“Primary” binary files like images are acceptable.</p>
+
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">find . <span class="p">|</span> xargs -n1 file <span class="p">|</span> awk -F <span class="s1">$':'</span> <span class="s1">' { t = $1; $1 = $2; $2 = t; print; } '</span> <span class="p">|</span> sort <span class="p">|</span> less</code></pre></div>
+
<h2 id="verify-the-operation-of-the-binary-distribution">Verify the operation of the binary distribution</h2>
<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd</span> <span class="nv">$TEMP_DIR</span>
@@ -496,6 +542,8 @@ artifact.</li>
made with voting open. This is then the point for the RM and the community to perform more detailed testing on the RC
artifacts and submit bug reports and votes.</p>
+<p>Automated sanity check script available at brooklyn-dist/release/verity_brooklyn_rc.sh</p>
+
<h2 id="if-the-sanity-check-fails">If the sanity check fails</h2>
<p>Note the problems causing the failure, and file bug reports, start mailing list discussions etc., as appropriate.</p>
Modified: brooklyn/site/developers/committers/release-process/vote.html
URL: http://svn.apache.org/viewvc/brooklyn/site/developers/committers/release-process/vote.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/developers/committers/release-process/vote.html (original)
+++ brooklyn/site/developers/committers/release-process/vote.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
@@ -379,7 +386,7 @@ under the License.
<h2 id="start-the-vote">Start the vote</h2>
<p>A script to generate the voting email can be found in <code>brooklyn-dist/release/print-vote-email.sh</code>,
-taking a single argument being the staging repo link. For example:</p>
+taking a single argument being the staging repo ID. For example:</p>
<pre><code>brooklyn-dist/release/print-vote-email.sh orgapachebrooklyn-1234 | pbcopy
</code></pre>
@@ -439,6 +446,54 @@ The vote will be open for at least 72 ho
Thanks,
[Release manager name]</code></pre></div>
+<h2 id="discuss-the-vote">Discuss the vote</h2>
+<p>Open a parallel thread for a place to discuss the vote. Name it [DISCUSS]<subject of="" the="" voting="" email="">, replying
+to the vote email. Here's an example body for the email.</subject></p>
+
+<div class="highlight"><pre><code class="language-text" data-lang="text">This thread is for discussions related to the release vote.
+
+I should clarify what we are looking for in a release vote. Particularly,
+we are looking for people to download,validate, and test the release.
+Only if you are satisfied that the artifacts are correct and the quality is
+high enough, should you make a "+1" vote. Alongside your vote you should list
+the checks that you made.
+
+Here is a good example: http://markmail.org/message/gevsz2pdciraw6jw
+
+The vote is not simply about "the master branch contains the features I wanted" -
+it is about making sure that *these* artifacts are *correct* (e.g. they are
+not corrupted, hashes and signatures pass) and are of *sufficiently high
+quality* to be stamped as an official release of The Apache Software Foundation.
+
+Why test the artifacts when master is looking good? Here are some reasons:
+
+- somebody could have made a commit that broke it, since you last git pulled
+- the release branch could have been made at the wrong point, or inconsistently
+ between all of the submodules
+- something in the release process could have broken it
+- I could have made a mistake and corrupted the files
+- a problem with the Apache infrastructure could mean that the release files are
+ unobtainable or corrupted
+
+This is why the release manager needs you to download the actual release
+artifacts and try them out.
+
+The way Apache works can be a bit arcane sometimes, but it's all done with
+a reason. If the vote passes then the contents of the email and its links
+become "endorsed" by The Apache Software Foundation, and the Foundation will
+take on legal liability for them, forever.
+
+And of course we want the best possible experience for our users - so we need
+the actual release files to be tested manually to make sure that a mistake does
+not ruin the experience for users.
+
+So if you can spare an hour or more to download some of the artifacts and try
+them out, then it will be *very* useful! The vote lasts for three days so
+there's no need to rush to get a vote in.
+
+Thanks!
+[Release manager name]</code></pre></div>
+
<h2 id="reply-to-vote">Reply to vote</h2>
<p>Here is an example checklist (thanks Andrew Phillips for your thoroughness on jclouds!)</p>
Modified: brooklyn/site/developers/how-to-contribute.html
URL: http://svn.apache.org/viewvc/brooklyn/site/developers/how-to-contribute.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/developers/how-to-contribute.html (original)
+++ brooklyn/site/developers/how-to-contribute.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/developers/index.html
URL: http://svn.apache.org/viewvc/brooklyn/site/developers/index.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/developers/index.html (original)
+++ brooklyn/site/developers/index.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/developers/links.html
URL: http://svn.apache.org/viewvc/brooklyn/site/developers/links.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/developers/links.html (original)
+++ brooklyn/site/developers/links.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/documentation/faq.html
URL: http://svn.apache.org/viewvc/brooklyn/site/documentation/faq.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/documentation/faq.html (original)
+++ brooklyn/site/documentation/faq.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/documentation/glossary.html
URL: http://svn.apache.org/viewvc/brooklyn/site/documentation/glossary.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/documentation/glossary.html (original)
+++ brooklyn/site/documentation/glossary.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/documentation/index.html
URL: http://svn.apache.org/viewvc/brooklyn/site/documentation/index.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/documentation/index.html (original)
+++ brooklyn/site/documentation/index.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/documentation/other-docs.html
URL: http://svn.apache.org/viewvc/brooklyn/site/documentation/other-docs.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/documentation/other-docs.html (original)
+++ brooklyn/site/documentation/other-docs.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/download/index.html
URL: http://svn.apache.org/viewvc/brooklyn/site/download/index.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/download/index.html (original)
+++ brooklyn/site/download/index.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/download/verify.html
URL: http://svn.apache.org/viewvc/brooklyn/site/download/verify.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/download/verify.html (original)
+++ brooklyn/site/download/verify.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/index.html
URL: http://svn.apache.org/viewvc/brooklyn/site/index.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/index.html (original)
+++ brooklyn/site/index.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/learnmore/blueprint-tour.html
URL: http://svn.apache.org/viewvc/brooklyn/site/learnmore/blueprint-tour.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/learnmore/blueprint-tour.html (original)
+++ brooklyn/site/learnmore/blueprint-tour.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/learnmore/catalog/catalog-item.html
URL: http://svn.apache.org/viewvc/brooklyn/site/learnmore/catalog/catalog-item.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/learnmore/catalog/catalog-item.html (original)
+++ brooklyn/site/learnmore/catalog/catalog-item.html Fri Feb 10 17:04:25 2017
@@ -260,6 +260,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/learnmore/catalog/index.html
URL: http://svn.apache.org/viewvc/brooklyn/site/learnmore/catalog/index.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/learnmore/catalog/index.html (original)
+++ brooklyn/site/learnmore/catalog/index.html Fri Feb 10 17:04:25 2017
@@ -282,6 +282,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/learnmore/features/index.html
URL: http://svn.apache.org/viewvc/brooklyn/site/learnmore/features/index.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/learnmore/features/index.html (original)
+++ brooklyn/site/learnmore/features/index.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/learnmore/index.html
URL: http://svn.apache.org/viewvc/brooklyn/site/learnmore/index.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/learnmore/index.html (original)
+++ brooklyn/site/learnmore/index.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/learnmore/theory.html
URL: http://svn.apache.org/viewvc/brooklyn/site/learnmore/theory.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/learnmore/theory.html (original)
+++ brooklyn/site/learnmore/theory.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/meta/license.html
URL: http://svn.apache.org/viewvc/brooklyn/site/meta/license.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/meta/license.html (original)
+++ brooklyn/site/meta/license.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
Modified: brooklyn/site/meta/sitemap.html
URL: http://svn.apache.org/viewvc/brooklyn/site/meta/sitemap.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/meta/sitemap.html (original)
+++ brooklyn/site/meta/sitemap.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
@@ -1571,7 +1578,7 @@ under the License.
<a id="guide/yaml/yaml-reference.md" name="guide/yaml/yaml-reference.md" href="javascript:void(0);"></a>
<li>
- <a href="/v/latest/yaml/yaml-reference.html">Broooklyn YAML Blueprint Reference</a>
+ <a href="/v/latest/yaml/yaml-reference.html">YAML Blueprint Reference</a>
</li>
@@ -2628,7 +2635,7 @@ under the License.
<a name="" href="javascript:void(0);"></a>
<li>
- <a href="/v/latest/ops/locations/index.html#google-compute-engine-gce">Google Compute Engine</a>
+ <a href="/v/latest/ops/locations/index.html#azure-compute-arm">Azure Compute ARM</a>
</li>
@@ -2646,7 +2653,7 @@ under the License.
<a name="" href="javascript:void(0);"></a>
<li>
- <a href="/v/latest/ops/locations/index.html#ibm-softlayer">IBM Softlayer</a>
+ <a href="/v/latest/ops/locations/index.html#azure-compute-classic">Azure Compute Classic</a>
</li>
@@ -2682,7 +2689,25 @@ under the License.
<a name="" href="javascript:void(0);"></a>
<li>
- <a href="/v/latest/ops/locations/index.html#openstack">OpenStack</a>
+ <a href="/v/latest/ops/locations/index.html#google-compute-engine-gce">Google Compute Engine</a>
+
+
+</li>
+
+
+
+
+
+
+
+
+
+
+
+<a name="" href="javascript:void(0);"></a>
+<li>
+
+ <a href="/v/latest/ops/locations/index.html#ibm-softlayer">IBM Softlayer</a>
</li>
@@ -2712,6 +2737,24 @@ under the License.
+
+
+
+<a name="" href="javascript:void(0);"></a>
+<li>
+
+ <a href="/v/latest/ops/locations/index.html#openstack">OpenStack</a>
+
+
+</li>
+
+
+
+
+
+
+
+
<a id="guide/ops/locations/location-customizers.md" name="guide/ops/locations/location-customizers.md" href="javascript:void(0);"></a>
<li>
@@ -4016,6 +4059,22 @@ under the License.
</li>
+
+
+
+
+
+
+
+
+
+<a id="website/community/security/index.md" name="website/community/security/index.md" href="javascript:void(0);"></a>
+<li>
+
+ <a href="/community/security/index.html">Security Advisories</a>
+
+
+</li>
Modified: brooklyn/site/meta/versions.html
URL: http://svn.apache.org/viewvc/brooklyn/site/meta/versions.html?rev=1782490&r1=1782489&r2=1782490&view=diff
==============================================================================
--- brooklyn/site/meta/versions.html (original)
+++ brooklyn/site/meta/versions.html Fri Feb 10 17:04:25 2017
@@ -263,6 +263,13 @@ under the License.
<li>
+ <a href="/community/security/index.html">Security Advisories
+ </a>
+
+ </li>
+
+ <li>
+
<a href="https://issues.apache.org/jira/browse/BROOKLYN">Bug Tracker (JIRA)
<span class="octicon octicon-link-external"></span></a>
@@ -386,7 +393,7 @@ under the License.
<li><a href="/v/latest/misc/release-notes.html">Release Notes</a></li>
</ul>
-<p>This documentation was generated 26 Dec 2016.</p>
+<p>This documentation was generated 10 Feb 2017.</p>
<h2 id="version-history">Version History</h2>
@@ -510,6 +517,7 @@ these should not normally be used except
</li>
</ul>
+
</div>
<div class="col-md-3">