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=1925014&r1=1925013&r2=1925014&view=diff ============================================================================== --- brooklyn/site/developers/committers/release-process/release-version.html (original) +++ brooklyn/site/developers/committers/release-process/release-version.html Fri Apr 11 07:44:54 2025 @@ -25,7 +25,7 @@ <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/bootstrap.min.css" rel="stylesheet" /> <link href="/style/deps/octicons/octicons.css" rel="stylesheet" /> <link href="/style/deps/bootstrap-theme.css" rel="stylesheet" /> <link href="/style/deps/font-awesome-4.2.0/css/font-awesome.min.css" rel="stylesheet" /> @@ -33,7 +33,8 @@ <link href="/style/css/code.css" rel="stylesheet" /> <link href="/style/css/website.css" rel="stylesheet" /> -<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script> +<script type="text/javascript" src="/style/deps/jquery.js"></script> + </head> <body class="page"> @@ -55,11 +56,11 @@ <li class="dropdown"> - <a href="/learnmore/index.html" data-toggle="dropdown">learn more <span class="caret"></span></a> + <a href="/learnmore/" data-toggle="dropdown">learn more <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/learnmore/index.html">Learn More</a> + <a href="/learnmore/">Learn More</a> </li> <li class="divider"></li> @@ -72,7 +73,7 @@ <li > - <a href="/learnmore/features/index.html">Features + <a href="/learnmore/features/">Features </a> </li> @@ -86,7 +87,7 @@ <li > - <a href="/learnmore/catalog/index.html">Browse Catalog + <a href="/learnmore/catalog/">Browse Catalog </a> </li> @@ -98,11 +99,11 @@ <li class="dropdown"> - <a href="/v/latest/start/index.html" data-toggle="dropdown">get started <span class="caret"></span></a> + <a href="/v/latest/start/" data-toggle="dropdown">get started <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/v/latest/start/index.html">Get Started</a> + <a href="/v/latest/start/">Get Started</a> </li> <li class="divider"></li> @@ -148,17 +149,17 @@ <li class="dropdown"> - <a href="/documentation/index.html" data-toggle="dropdown">documentation <span class="caret"></span></a> + <a href="/documentation/" data-toggle="dropdown">documentation <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/documentation/index.html">Documentation</a> + <a href="/documentation/">Documentation</a> </li> <li class="divider"></li> <li class="section"> - <a href="/v/latest/index.html">User Guide + <a href="/v/latest/">User Guide </a> </li> <li class="divider"></li> @@ -172,21 +173,21 @@ <li > - <a href="/v/latest/locations/index.html">Deploying Blueprints + <a href="/v/latest/locations/">Deploying Blueprints </a> </li> <li class="section"> - <a href="/v/latest/ops/index.html">Reference Guide + <a href="/v/latest/ops/">Reference Guide </a> </li> <li class="divider"></li> <li > - <a href="/v/latest/dev/index.html">Developer Guide + <a href="/v/latest/dev/">Developer Guide </a> </li> @@ -212,11 +213,11 @@ <li class="dropdown"> - <a href="/community/index.html" data-toggle="dropdown">community <span class="caret"></span></a> + <a href="/community/" data-toggle="dropdown">community <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/community/index.html">Community</a> + <a href="/community/">Community</a> </li> <li class="divider"></li> @@ -236,7 +237,7 @@ <li > - <a href="/community/security/index.html">Security Advisories + <a href="/community/security/">Security Advisories </a> </li> @@ -257,8 +258,8 @@ <li > - <a href="/community/gsoc.html">Google Summer of Code - </a> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy Policy + <span class="octicon octicon-link-external"></span></a> </li> @@ -269,17 +270,17 @@ <li class="dropdown active"> - <a href="/developers/index.html" data-toggle="dropdown">developers <span class="caret"></span></a> + <a href="/developers/" data-toggle="dropdown">developers <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/developers/index.html">Developers</a> + <a href="/developers/">Developers</a> </li> <li class="divider"></li> <li > - <a href="/developers/code/index.html">Get the Code + <a href="/developers/code/">Get the Code </a> </li> @@ -293,14 +294,14 @@ <li > - <a href="/v/latest/dev/index.html">Developer Guide + <a href="/v/latest/dev/">Developer Guide </a> </li> <li > - <a href="/developers/committers/index.html">Committer Guide + <a href="/developers/committers/">Committer Guide </a> </li> @@ -340,7 +341,7 @@ <li class="dropdown"> - <a href="/download/index.html" class="btn btn-default navbar-btn">download</a> + <a href="/download/" class="btn btn-default navbar-btn">download</a> </li> @@ -375,57 +376,57 @@ folder with the correct name.)</p> <p>Create a branch with the same name as the version, based off master:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">git checkout master -git pull --rebase <span class="c"># assumes that the Apache canonical repository is the default upstream for your master - amend if necessary</span> -git submodule update --remote --merge --recursive -<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 checkout master <span class="o">&&</span> git checkout -b <span class="nv">$VERSION_NAME</span> <span class="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash">git checkout master +git pull <span class="nt">--rebase</span> <span class="c"># assumes that the Apache canonical repository is the default upstream for your master - amend if necessary</span> +git submodule update <span class="nt">--remote</span> <span class="nt">--merge</span> <span class="nt">--recursive</span> +<span class="k">for </span>m <span class="k">in</span> <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 checkout master <span class="o">&&</span> git checkout <span class="nt">-b</span> <span class="nv">$VERSION_NAME</span> <span class="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></figure> -<p>Now change the version numbers in this branch throughout the project using the script <code>brooklyn-dist/release/change-version.sh</code> and commit it:</p> +<p>Now change the version numbers in this branch throughout the project using the script <code class="language-plaintext highlighter-rouge">brooklyn-dist/release/change-version.sh</code> and commit it:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">./brooklyn-dist/release/change-version.sh BROOKLYN <span class="nv">$OLD_MASTER_VERSION</span> <span class="nv">$VERSION_NAME</span> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash">./brooklyn-dist/release/change-version.sh BROOKLYN <span class="nv">$OLD_MASTER_VERSION</span> <span class="nv">$VERSION_NAME</span> <span class="c"># Now inspect the changes and ensure there are no surprises</span> -find . -name <span class="s2">"*.bak"</span> -delete -<span class="k">for</span> m in <span class="nv">$SUBMODULES</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 add . <span class="o">&&</span> git commit -m <span class="s2">"Change version to $VERSION_NAME"</span> <span class="o">)</span><span class="p">;</span> <span class="k">done</span> -git add <span class="nv">$SUBMODULES</span> <span class="o">&&</span> git commit -m <span class="s2">"Update submodules to $VERSION_NAME"</span> -git add . <span class="o">&&</span> git commit -m <span class="s2">"Change version to $VERSION_NAME"</span></code></pre></div> +find <span class="nb">.</span> <span class="nt">-name</span> <span class="s2">"*.bak"</span> <span class="nt">-delete</span> +<span class="k">for </span>m <span class="k">in</span> <span class="nv">$SUBMODULES</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 add <span class="nb">.</span> <span class="o">&&</span> git commit <span class="nt">-m</span> <span class="s2">"Change version to </span><span class="nv">$VERSION_NAME</span><span class="s2">"</span> <span class="o">)</span><span class="p">;</span> <span class="k">done +</span>git add <span class="nv">$SUBMODULES</span> <span class="o">&&</span> git commit <span class="nt">-m</span> <span class="s2">"Update submodules to </span><span class="nv">$VERSION_NAME</span><span class="s2">"</span> +git add <span class="nb">.</span> <span class="o">&&</span> git commit <span class="nt">-m</span> <span class="s2">"Change version to </span><span class="nv">$VERSION_NAME</span><span class="s2">"</span></code></pre></figure> <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_NAME</span> <span class="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for </span>m <span class="k">in</span> <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></figure> <h2 id="update-the-version-on-master">Update the version on master</h2> -<p>The <code>master</code> branch will now need updating to refer to the next planned version. (This step is not required if making +<p>The <code class="language-plaintext highlighter-rouge">master</code> branch will now need updating to refer to the next planned version. (This step is not required if making a âmilestoneâ release or similar.)</p> <p>The release notes should be cleared out and the version history augmented with the new version.</p> <p>Example:</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 checkout master <span class="o">)</span><span class="p">;</span> <span class="k">done</span> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for </span>m <span class="k">in</span> <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 checkout master <span class="o">)</span><span class="p">;</span> <span class="k">done</span> ./brooklyn-dist/release/change-version.sh BROOKLYN <span class="nv">$OLD_MASTER_VERSION</span> <span class="nv">$NEW_MASTER_VERSION</span> -<span class="c"># Now inspect the changes and ensure there are no surprises</span></code></pre></div> +<span class="c"># Now inspect the changes and ensure there are no surprises</span></code></pre></figure> -<p>Open <code>brooklyn-docs/guide/misc/release-notes.md</code> and <code>brooklyn-docs/website/meta/versions.md</code> in your favourite editor and amend. +<p>Open <code class="language-plaintext highlighter-rouge">brooklyn-docs/guide/misc/release-notes.md</code> and <code class="language-plaintext highlighter-rouge">brooklyn-docs/website/meta/versions.md</code> in your favourite editor and amend. For release notes this means bumping the reference to the previous version in the âBackwards Compatibilityâ section and putting some placeholder text elsewhere.</p> <p>Then:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">find . -name <span class="s2">"*.bak"</span> -delete -<span class="k">for</span> m in <span class="nv">$SUBMODULES</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 add . <span class="o">&&</span> git commit -m <span class="s2">"Change version to $NEW_MASTER_VERSION"</span> <span class="o">)</span><span class="p">;</span> <span class="k">done</span> -git add <span class="nv">$SUBMODULES</span> <span class="o">&&</span> git commit -m <span class="s2">"Update submodules to $NEW_MASTER_VERSION"</span> -git add . <span class="o">&&</span> git commit -m <span class="s2">"Change version to $NEW_MASTER_VERSION"</span></code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash">find <span class="nb">.</span> <span class="nt">-name</span> <span class="s2">"*.bak"</span> <span class="nt">-delete</span> +<span class="k">for </span>m <span class="k">in</span> <span class="nv">$SUBMODULES</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 add <span class="nb">.</span> <span class="o">&&</span> git commit <span class="nt">-m</span> <span class="s2">"Change version to </span><span class="nv">$NEW_MASTER_VERSION</span><span class="s2">"</span> <span class="o">)</span><span class="p">;</span> <span class="k">done +</span>git add <span class="nv">$SUBMODULES</span> <span class="o">&&</span> git commit <span class="nt">-m</span> <span class="s2">"Update submodules to </span><span class="nv">$NEW_MASTER_VERSION</span><span class="s2">"</span> +git add <span class="nb">.</span> <span class="o">&&</span> git commit <span class="nt">-m</span> <span class="s2">"Change version to </span><span class="nv">$NEW_MASTER_VERSION</span><span class="s2">"</span></code></pre></figure> <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 master <span class="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for </span>m <span class="k">in</span> <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 master <span class="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></figure> <h2 id="switch-back-to-the-release-branch">Switch back to the release branch</h2> <p>Move back to the release branch:</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 checkout <span class="nv">$VERSION_NAME</span> <span class="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for </span>m <span class="k">in</span> <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 checkout <span class="nv">$VERSION_NAME</span> <span class="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></figure> </div> @@ -439,17 +440,17 @@ git add . <span class="o">&&</sp <h4 class=" with_following"> - <a href="/developers/index.html" class="list-group-item breadcrumb breadcrumb0"> + <a href="/developers/" class="list-group-item breadcrumb breadcrumb0"> Developers </a></h4> <h4 class=" with_preceding with_following"> - <a href="/developers/committers/index.html" class="list-group-item breadcrumb breadcrumb1"> + <a href="/developers/committers/" class="list-group-item breadcrumb breadcrumb1"> Committer Guide </a></h4> <h4 class=" with_preceding"> - <a href="/developers/committers/release-process/index.html" class="list-group-item breadcrumb breadcrumb2"> + <a href="/developers/committers/release-process/" class="list-group-item breadcrumb breadcrumb2"> Release Process </a></h4> @@ -715,8 +716,8 @@ git add . <span class="o">&&</sp </div> <div class="col-md-3 text-right"> <p> - <a class="btn btn-sm btn-default" href="https://github.com/apache/brooklyn-docs/edit/website/developers/committers/release-process/release-version.md">Edit This Page</a> - <a href="https://brooklyn.apache.org/community/how-to-contribute-docs.html" + <a class="btn btn-sm btn-default" href="https://github.com/apache/brooklyn-docs/edit/master/website/developers/committers/release-process/release-version.md">Edit This Page</a> + <a href="/community/how-to-contribute-docs.html" data-toggle="tooltip" data-placement="top" title="" data-delay="400" data-original-title="How to Edit Documentation"> <span class="octicon octicon-question octicon-footer"></span> </a> @@ -755,4 +756,5 @@ git add . <span class="o">&&</sp ZeroClipboard.config({ moviePath: '/style/js/zeroclipboard/ZeroClipboard.swf' }); </script> <script src="/style/js/public.js"></script> + </html>
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=1925014&r1=1925013&r2=1925014&view=diff ============================================================================== --- brooklyn/site/developers/committers/release-process/verify-release-artifacts.html (original) +++ brooklyn/site/developers/committers/release-process/verify-release-artifacts.html Fri Apr 11 07:44:54 2025 @@ -25,7 +25,7 @@ <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/bootstrap.min.css" rel="stylesheet" /> <link href="/style/deps/octicons/octicons.css" rel="stylesheet" /> <link href="/style/deps/bootstrap-theme.css" rel="stylesheet" /> <link href="/style/deps/font-awesome-4.2.0/css/font-awesome.min.css" rel="stylesheet" /> @@ -33,7 +33,8 @@ <link href="/style/css/code.css" rel="stylesheet" /> <link href="/style/css/website.css" rel="stylesheet" /> -<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script> +<script type="text/javascript" src="/style/deps/jquery.js"></script> + </head> <body class="page"> @@ -55,11 +56,11 @@ <li class="dropdown"> - <a href="/learnmore/index.html" data-toggle="dropdown">learn more <span class="caret"></span></a> + <a href="/learnmore/" data-toggle="dropdown">learn more <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/learnmore/index.html">Learn More</a> + <a href="/learnmore/">Learn More</a> </li> <li class="divider"></li> @@ -72,7 +73,7 @@ <li > - <a href="/learnmore/features/index.html">Features + <a href="/learnmore/features/">Features </a> </li> @@ -86,7 +87,7 @@ <li > - <a href="/learnmore/catalog/index.html">Browse Catalog + <a href="/learnmore/catalog/">Browse Catalog </a> </li> @@ -98,11 +99,11 @@ <li class="dropdown"> - <a href="/v/latest/start/index.html" data-toggle="dropdown">get started <span class="caret"></span></a> + <a href="/v/latest/start/" data-toggle="dropdown">get started <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/v/latest/start/index.html">Get Started</a> + <a href="/v/latest/start/">Get Started</a> </li> <li class="divider"></li> @@ -148,17 +149,17 @@ <li class="dropdown"> - <a href="/documentation/index.html" data-toggle="dropdown">documentation <span class="caret"></span></a> + <a href="/documentation/" data-toggle="dropdown">documentation <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/documentation/index.html">Documentation</a> + <a href="/documentation/">Documentation</a> </li> <li class="divider"></li> <li class="section"> - <a href="/v/latest/index.html">User Guide + <a href="/v/latest/">User Guide </a> </li> <li class="divider"></li> @@ -172,21 +173,21 @@ <li > - <a href="/v/latest/locations/index.html">Deploying Blueprints + <a href="/v/latest/locations/">Deploying Blueprints </a> </li> <li class="section"> - <a href="/v/latest/ops/index.html">Reference Guide + <a href="/v/latest/ops/">Reference Guide </a> </li> <li class="divider"></li> <li > - <a href="/v/latest/dev/index.html">Developer Guide + <a href="/v/latest/dev/">Developer Guide </a> </li> @@ -212,11 +213,11 @@ <li class="dropdown"> - <a href="/community/index.html" data-toggle="dropdown">community <span class="caret"></span></a> + <a href="/community/" data-toggle="dropdown">community <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/community/index.html">Community</a> + <a href="/community/">Community</a> </li> <li class="divider"></li> @@ -236,7 +237,7 @@ <li > - <a href="/community/security/index.html">Security Advisories + <a href="/community/security/">Security Advisories </a> </li> @@ -257,8 +258,8 @@ <li > - <a href="/community/gsoc.html">Google Summer of Code - </a> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy Policy + <span class="octicon octicon-link-external"></span></a> </li> @@ -269,17 +270,17 @@ <li class="dropdown active"> - <a href="/developers/index.html" data-toggle="dropdown">developers <span class="caret"></span></a> + <a href="/developers/" data-toggle="dropdown">developers <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/developers/index.html">Developers</a> + <a href="/developers/">Developers</a> </li> <li class="divider"></li> <li > - <a href="/developers/code/index.html">Get the Code + <a href="/developers/code/">Get the Code </a> </li> @@ -293,14 +294,14 @@ <li > - <a href="/v/latest/dev/index.html">Developer Guide + <a href="/v/latest/dev/">Developer Guide </a> </li> <li > - <a href="/developers/committers/index.html">Committer Guide + <a href="/developers/committers/">Committer Guide </a> </li> @@ -340,7 +341,7 @@ <li class="dropdown"> - <a href="/download/index.html" class="btn btn-default navbar-btn">download</a> + <a href="/download/" class="btn btn-default navbar-btn">download</a> </li> @@ -358,15 +359,15 @@ <h1>Verify the release artifacts</h1> <p>Below is described a series of âsanity checksâ that should be performed before uploading the artifacts to the pre-release area. They are also useful for community members that want to check the artifact before voting (community -members may also want to check the <a href="prerequisites.html#software-packages">list of required software packages</a> to ensure -they have the GnuPG installed.</p> +members may also want to check the <a href="/developers/committers/release-process/prerequisites.html#software-packages">list of required software packages</a> to ensure +they have the GnuPG and md5sum/sha1sum installed.</p> <h2 id="setup">Setup</h2> <p>The scripts below use several environment variables to cut out repetition and enable easy repeatability for the next 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> +<figure 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.10.0 <span class="c"># The release candidate number we are making now.</span> @@ -375,12 +376,12 @@ release. You should determine the follow <span class="c"># A reference to your Git repository for Brooklyn</span> <span class="nv">BASE_REPO</span><span class="o">=</span>~/repos/apache-asf/brooklyn -<span class="c"># The Git commit hash from which the release was made - get this from the release script, or the Release Manager's announcement</span> -<span class="nv">GIT_COMMIT</span><span class="o">=</span>edcf928ee65cc29a84376c822759e468a9f016fe</code></pre></div> +<span class="c"># The Git commit hash from which the release was made - get this from the release script, or the Release Manager's announcement</span> +<span class="nv">GIT_COMMIT</span><span class="o">=</span>edcf928ee65cc29a84376c822759e468a9f016fe</code></pre></figure> <p>Import the PGP keys of the release Managers:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">curl https://dist.apache.org/repos/dist/release/brooklyn/KEYS <span class="p">|</span> gpg2 --import</code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash">curl https://dist.apache.org/repos/dist/release/brooklyn/KEYS | gpg2 <span class="nt">--import</span></code></pre></figure> <h2 id="download-the-artifacts">Download the artifacts</h2> @@ -388,59 +389,61 @@ release. You should determine the follow <p>If youâre verifying a build someone else has made, first download the files including all keys using:</p> -<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> +<figure 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><span class="nt">-rc</span><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><span class="nt">-rc</span><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>/ -mkdir -p <span class="k">${</span><span class="nv">TEMP_DIR</span><span class="k">}</span> +<span class="nb">mkdir</span> <span class="nt">-p</span> <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> -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> +curl <span class="nt">-s</span> <span class="nv">$BASE_URL</span> | <span class="se">\</span> + <span class="nb">grep </span>href | <span class="nb">grep</span> <span class="nt">-v</span> <span class="s1">'\.\.'</span> | <span class="se">\</span> + <span class="nb">sed</span> <span class="nt">-e</span> <span class="s1">'s@.*href="@'</span><span class="nv">$BASE_URL</span><span class="s1">'@'</span> | <span class="se">\</span> + <span class="nb">sed</span> <span class="nt">-e</span> <span class="s1">'s@">.*@@'</span> | <span class="se">\</span> + xargs <span class="nt">-n</span> 1 curl <span class="nt">-O</span></code></pre></figure> -<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> +<p>(Alternatively if you have <code class="language-plaintext highlighter-rouge">apache-dist-dev-repo</code> checked out, +you can do an <code class="language-plaintext highlighter-rouge">svn up</code> in there and <code class="language-plaintext highlighter-rouge">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">'*.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> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for </span>ARCHIVE <span class="k">in</span> <span class="si">$(</span>find <span class="k">*</span> <span class="nt">-type</span> f <span class="o">!</span> <span class="se">\(</span> <span class="nt">-name</span> <span class="s1">'*.asc'</span> <span class="nt">-o</span> <span class="nt">-name</span> <span class="s1">'*.md5'</span> <span class="nt">-o</span> <span class="nt">-name</span> <span class="s1">'*.sha1'</span> <span class="nt">-o</span> <span class="nt">-name</span> <span class="s1">'*.sha256'</span> <span class="se">\)</span> <span class="si">)</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> <span class="k">in</span> + <span class="k">*</span>.tar.gz<span class="p">)</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="k">*</span>.zip<span class="p">)</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="k">*</span>.rpm<span class="p">)</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="k">*</span><span class="p">)</span> + <span class="nb">echo</span> <span class="s2">"Unrecognized file type </span><span class="nv">$ARCHIVE</span><span class="s2">. 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> + <span class="nv">$LIST</span> <span class="nv">$ARCHIVE</span> | <span class="nb">grep</span> <span class="s2">"</span><span class="nv">$PREFIX</span><span class="s2">/NOTICE"</span> <span class="o">&&</span> <span class="se">\</span> + <span class="nv">$LIST</span> <span class="nv">$ARCHIVE</span> | <span class="nb">grep</span> <span class="s2">"</span><span class="nv">$PREFIX</span><span class="s2">/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 </span><span class="nv">$ARCHIVE</span><span class="s2">. 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></figure> <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> artifact in <span class="k">$(</span>find * -type f ! <span class="se">\(</span> -name <span class="s1">'*.asc'</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> - 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> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for </span>artifact <span class="k">in</span> <span class="si">$(</span>find <span class="k">*</span> <span class="nt">-type</span> f <span class="o">!</span> <span class="se">\(</span> <span class="nt">-name</span> <span class="s1">'*.asc'</span> <span class="nt">-o</span> <span class="nt">-name</span> <span class="s1">'*.md5'</span> <span class="nt">-o</span> <span class="nt">-name</span> <span class="s1">'*.sha1'</span> <span class="nt">-o</span> <span class="nt">-name</span> <span class="s1">'*.sha256'</span> <span class="se">\)</span> <span class="si">)</span><span class="p">;</span> <span class="k">do + </span><span class="nb">md5sum</span> <span class="nt">-c</span> <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.md5 <span class="o">&&</span> <span class="se">\</span> + shasum <span class="nt">-a1</span> <span class="nt">-c</span> <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha1 <span class="o">&&</span> <span class="se">\</span> + shasum <span class="nt">-a256</span> <span class="nt">-c</span> <span class="k">${</span><span class="nv">artifact</span><span class="k">}</span>.sha256 <span class="o">&&</span> <span class="se">\</span> + gpg2 <span class="nt">--verify</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> <span class="se">\</span> + <span class="o">||</span> <span class="o">{</span> <span class="nb">echo</span> <span class="s2">"Invalid signature for </span><span class="nv">$artifact</span><span class="s2">. 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></figure> <h2 id="verify-expanded-source-archive-matches-contents-of-rc-tag">Verify expanded source archive matches contents of RC tag</h2> @@ -449,53 +452,53 @@ there will be some differences: we canno appear to be missing from the source release, and the source release excludes the documentation, website and release scripts.</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd</span> <span class="nv">$BASE_REPO</span> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd</span> <span class="nv">$BASE_REPO</span> git checkout <span class="nv">$GIT_COMMIT</span> -git clean -d -f -x <span class="c"># WARNING: this will forcibly clean your workspace!</span> +git clean <span class="nt">-d</span> <span class="nt">-f</span> <span class="nt">-x</span> <span class="c"># WARNING: this will forcibly clean your workspace!</span> <span class="nb">cd</span> <span class="nv">$TEMP_DIR</span> -mkdir unpacked-src +<span class="nb">mkdir </span>unpacked-src <span class="c"># Either:</span> -tar xzf <span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}</span>-src.tar.gz -C unpacked-src/ +<span class="nb">tar </span>xzf <span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}</span><span class="nt">-src</span>.tar.gz <span class="nt">-C</span> unpacked-src/ <span class="c"># or:</span> -unzip <span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}</span>-src.zip -d unpacked-src/ +unzip <span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}</span><span class="nt">-src</span>.zip <span class="nt">-d</span> unpacked-src/ <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> +diff <span class="nt">-qr</span> unpacked-src/<span class="nv">$BASE_NAME</span> <span class="nv">$BASE_REPO</span></code></pre></figure> <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> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">grep</span> <span class="nt">-rL</span> <span class="s2">"Licensed to the Apache Software Foundation"</span> <span class="k">*</span> | less</code></pre></figure> <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> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash">find <span class="nb">.</span> | xargs <span class="nt">-n1</span> file | <span class="nb">awk</span> <span class="nt">-F</span> <span class="s1">$':'</span> <span class="s1">' { t = $1; $1 = $2; $2 = t; print; } '</span> | <span class="nb">sort</span> | less</code></pre></figure> <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> -mkdir unpacked-bin +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd</span> <span class="nv">$TEMP_DIR</span> +<span class="nb">mkdir </span>unpacked-bin <span class="c"># Either:</span> -tar xzf <span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}</span>-bin.tar.gz -C unpacked-bin/ +<span class="nb">tar </span>xzf <span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}</span><span class="nt">-bin</span>.tar.gz <span class="nt">-C</span> unpacked-bin/ <span class="c"># or:</span> -unzip <span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}</span>-bin.tar.gz -d unpacked-bin/ +unzip <span class="k">${</span><span class="nv">BASE_NAME</span><span class="k">}</span><span class="nt">-bin</span>.tar.gz <span class="nt">-d</span> unpacked-bin/ <span class="c"># (or preferably both!)</span> <span class="nb">cd </span>unpacked-bin -./bin/brooklyn launch</code></pre></div> +./bin/brooklyn launch</code></pre></figure> <p>Try deploying a simple app, such as the YAML:</p> -<div class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="l-Scalar-Plain">location</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">localhost</span> -<span class="l-Scalar-Plain">services</span><span class="p-Indicator">:</span> -<span class="p-Indicator">-</span> <span class="l-Scalar-Plain">type</span><span class="p-Indicator">:</span> <span class="l-Scalar-Plain">org.apache.brooklyn.entity.webapp.jboss.JBoss7Server</span></code></pre></div> +<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="na">location</span><span class="pi">:</span> <span class="s">localhost</span> +<span class="na">services</span><span class="pi">:</span> +<span class="pi">-</span> <span class="na">type</span><span class="pi">:</span> <span class="s">org.apache.brooklyn.entity.webapp.jboss.JBoss7Server</span></code></pre></figure> <h2 id="inspect-the-maven-staging-repository">Inspect the Maven staging repository</h2> <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 click the repository with the name starting <code>orgapachebrooklyn</code>.</p> +Repositoriesâ page, and click the repository with the name starting <code class="language-plaintext highlighter-rouge">orgapachebrooklyn</code>.</p> <p>Give this a brief inspection to ensure that it looks reasonable. In particular:</p> @@ -503,7 +506,7 @@ Repositoriesâ page, and click the r <li>The expected projects are there. (There is no need to do an exhaustive check - but if there is only a couple of projects there, then something has clearly gone wrong!)</li> <li>The projects contain artifacts with the expected version number.</li> - <li>The artifacts for a project look reasonable - and there is a <code>.asc</code> file (detached PGP cleartext signature) for each + <li>The artifacts for a project look reasonable - and there is a <code class="language-plaintext highlighter-rouge">.asc</code> file (detached PGP cleartext signature) for each artifact.</li> </ul> @@ -526,7 +529,7 @@ artifacts and submit bug reports and vot <p>You will also need to drop the Maven staging repository on Apacheâs Nexus server: 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>Drop</strong> button.</p> +repository with the name starting <code class="language-plaintext highlighter-rouge">orgapachebrooklyn</code>. Click the <strong>Drop</strong> button.</p> </div> @@ -539,17 +542,17 @@ repository with the name starting <code> <h4 class=" with_following"> - <a href="/developers/index.html" class="list-group-item breadcrumb breadcrumb0"> + <a href="/developers/" class="list-group-item breadcrumb breadcrumb0"> Developers </a></h4> <h4 class=" with_preceding with_following"> - <a href="/developers/committers/index.html" class="list-group-item breadcrumb breadcrumb1"> + <a href="/developers/committers/" class="list-group-item breadcrumb breadcrumb1"> Committer Guide </a></h4> <h4 class=" with_preceding"> - <a href="/developers/committers/release-process/index.html" class="list-group-item breadcrumb breadcrumb2"> + <a href="/developers/committers/release-process/" class="list-group-item breadcrumb breadcrumb2"> Release Process </a></h4> @@ -815,8 +818,8 @@ repository with the name starting <code> </div> <div class="col-md-3 text-right"> <p> - <a class="btn btn-sm btn-default" href="https://github.com/apache/brooklyn-docs/edit/website/developers/committers/release-process/verify-release-artifacts.md">Edit This Page</a> - <a href="https://brooklyn.apache.org/community/how-to-contribute-docs.html" + <a class="btn btn-sm btn-default" href="https://github.com/apache/brooklyn-docs/edit/master/website/developers/committers/release-process/verify-release-artifacts.md">Edit This Page</a> + <a href="/community/how-to-contribute-docs.html" data-toggle="tooltip" data-placement="top" title="" data-delay="400" data-original-title="How to Edit Documentation"> <span class="octicon octicon-question octicon-footer"></span> </a> @@ -855,4 +858,5 @@ repository with the name starting <code> ZeroClipboard.config({ moviePath: '/style/js/zeroclipboard/ZeroClipboard.swf' }); </script> <script src="/style/js/public.js"></script> + </html> Modified: brooklyn/site/developers/committers/release-process/vote.html URL: http://svn.apache.org/viewvc/brooklyn/site/developers/committers/release-process/vote.html?rev=1925014&r1=1925013&r2=1925014&view=diff ============================================================================== --- brooklyn/site/developers/committers/release-process/vote.html (original) +++ brooklyn/site/developers/committers/release-process/vote.html Fri Apr 11 07:44:54 2025 @@ -25,7 +25,7 @@ <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/bootstrap.min.css" rel="stylesheet" /> <link href="/style/deps/octicons/octicons.css" rel="stylesheet" /> <link href="/style/deps/bootstrap-theme.css" rel="stylesheet" /> <link href="/style/deps/font-awesome-4.2.0/css/font-awesome.min.css" rel="stylesheet" /> @@ -33,7 +33,8 @@ <link href="/style/css/code.css" rel="stylesheet" /> <link href="/style/css/website.css" rel="stylesheet" /> -<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script> +<script type="text/javascript" src="/style/deps/jquery.js"></script> + </head> <body class="page"> @@ -55,11 +56,11 @@ <li class="dropdown"> - <a href="/learnmore/index.html" data-toggle="dropdown">learn more <span class="caret"></span></a> + <a href="/learnmore/" data-toggle="dropdown">learn more <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/learnmore/index.html">Learn More</a> + <a href="/learnmore/">Learn More</a> </li> <li class="divider"></li> @@ -72,7 +73,7 @@ <li > - <a href="/learnmore/features/index.html">Features + <a href="/learnmore/features/">Features </a> </li> @@ -86,7 +87,7 @@ <li > - <a href="/learnmore/catalog/index.html">Browse Catalog + <a href="/learnmore/catalog/">Browse Catalog </a> </li> @@ -98,11 +99,11 @@ <li class="dropdown"> - <a href="/v/latest/start/index.html" data-toggle="dropdown">get started <span class="caret"></span></a> + <a href="/v/latest/start/" data-toggle="dropdown">get started <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/v/latest/start/index.html">Get Started</a> + <a href="/v/latest/start/">Get Started</a> </li> <li class="divider"></li> @@ -148,17 +149,17 @@ <li class="dropdown"> - <a href="/documentation/index.html" data-toggle="dropdown">documentation <span class="caret"></span></a> + <a href="/documentation/" data-toggle="dropdown">documentation <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/documentation/index.html">Documentation</a> + <a href="/documentation/">Documentation</a> </li> <li class="divider"></li> <li class="section"> - <a href="/v/latest/index.html">User Guide + <a href="/v/latest/">User Guide </a> </li> <li class="divider"></li> @@ -172,21 +173,21 @@ <li > - <a href="/v/latest/locations/index.html">Deploying Blueprints + <a href="/v/latest/locations/">Deploying Blueprints </a> </li> <li class="section"> - <a href="/v/latest/ops/index.html">Reference Guide + <a href="/v/latest/ops/">Reference Guide </a> </li> <li class="divider"></li> <li > - <a href="/v/latest/dev/index.html">Developer Guide + <a href="/v/latest/dev/">Developer Guide </a> </li> @@ -212,11 +213,11 @@ <li class="dropdown"> - <a href="/community/index.html" data-toggle="dropdown">community <span class="caret"></span></a> + <a href="/community/" data-toggle="dropdown">community <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/community/index.html">Community</a> + <a href="/community/">Community</a> </li> <li class="divider"></li> @@ -236,7 +237,7 @@ <li > - <a href="/community/security/index.html">Security Advisories + <a href="/community/security/">Security Advisories </a> </li> @@ -257,8 +258,8 @@ <li > - <a href="/community/gsoc.html">Google Summer of Code - </a> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy Policy + <span class="octicon octicon-link-external"></span></a> </li> @@ -269,17 +270,17 @@ <li class="dropdown active"> - <a href="/developers/index.html" data-toggle="dropdown">developers <span class="caret"></span></a> + <a href="/developers/" data-toggle="dropdown">developers <span class="caret"></span></a> <ul class="dropdown-menu" role="menu"> <li> - <a href="/developers/index.html">Developers</a> + <a href="/developers/">Developers</a> </li> <li class="divider"></li> <li > - <a href="/developers/code/index.html">Get the Code + <a href="/developers/code/">Get the Code </a> </li> @@ -293,14 +294,14 @@ <li > - <a href="/v/latest/dev/index.html">Developer Guide + <a href="/v/latest/dev/">Developer Guide </a> </li> <li > - <a href="/developers/committers/index.html">Committer Guide + <a href="/developers/committers/">Committer Guide </a> </li> @@ -340,7 +341,7 @@ <li class="dropdown"> - <a href="/download/index.html" class="btn btn-default navbar-btn">download</a> + <a href="/download/" class="btn btn-default navbar-btn">download</a> </li> @@ -358,11 +359,11 @@ <h1>Vote on dev@brooklyn</h1> <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>, +<p>A script to generate the voting email can be found in <code class="language-plaintext highlighter-rouge">brooklyn-dist/release/print-vote-email.sh</code>, 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> +<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>brooklyn-dist/release/print-vote-email.sh orgapachebrooklyn-1234 | pbcopy +</code></pre></div></div> <p>You should move the subject and put your name at the end, and simply eyeball the rest. This should be sent to <strong>[email protected]</strong>.</p> @@ -377,9 +378,9 @@ taking a single argument being the stagi <li>URL for the Maven staging repository</li> </ul> -<h3 id="subject-vote-release-apache-brooklyn-versionname-rcrcnumber">Subject: [VOTE] Release Apache Brooklyn ${VERSION_NAME} [rc${RC_NUMBER}]</h3> +<h3 id="subject-vote-release-apache-brooklyn-version_name-rcrc_number">Subject: [VOTE] Release Apache Brooklyn ${VERSION_NAME} [rc${RC_NUMBER}]</h3> -<div class="highlight"><pre><code class="language-text" data-lang="text">This is to call for a vote for the release of Apache Brooklyn ${VERSION_NAME}. +<figure class="highlight"><pre><code class="language-text" data-lang="text">This is to call for a vote for the release of Apache Brooklyn ${VERSION_NAME}. This release comprises of a source code distribution, and a corresponding binary distribution, and Maven artifacts. @@ -405,7 +406,7 @@ https://dist.apache.org/repos/dist/relea The artifacts were built from Git commit ID 24a23c5a4fd5967725930b8ceaed61dfbd225980 -https://gitbox.apache.org/repos/asf?p=brooklyn.git;a=commit;h=24a23c5a4fd5967725930b8ceaed61dfbd225980 +https://git-wip-us.apache.org/repos/asf?p=brooklyn.git;a=commit;h=24a23c5a4fd5967725930b8ceaed61dfbd225980 Please vote on releasing this package as Apache Brooklyn ${VERSION_NAME}. @@ -417,23 +418,23 @@ The vote will be open for at least 72 ho Thanks, -[Release manager name]</code></pre></div> +[Release manager name]</code></pre></figure> <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> +<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. +<figure 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 +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" - +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. @@ -451,9 +452,9 @@ Why test the artifacts when master is lo 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 +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 +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 @@ -462,10 +463,10 @@ 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. +there's no need to rush to get a vote in. Thanks! -[Release manager name]</code></pre></div> +[Release manager name]</code></pre></figure> <h2 id="reply-to-vote">Reply to vote</h2> @@ -473,16 +474,16 @@ Thanks! <p>Checklist (all items optional, mark only those personally verified):</p> -<ul> - <li>[ ] Checksums and PGP signatures are valid.</li> - <li>[ ] Expanded source archive matches contents of RC tag.</li> - <li>[ ] Expanded source archive builds and passes tests.</li> - <li>[ ] LICENSE is present and correct.</li> - <li>[ ] NOTICE is present and correct, including copyright date.</li> - <li>[ ] All files have license headers where appropriate.</li> - <li>[ ] All dependencies have compatible licenses.</li> - <li>[ ] No compiled archives bundled in source archive.</li> - <li>[ ] I follow this projectâs commits list.</li> +<ul class="task-list"> + <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />Checksums and PGP signatures are valid.</li> + <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />Expanded source archive matches contents of RC tag.</li> + <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />Expanded source archive builds and passes tests.</li> + <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />LICENSE is present and correct.</li> + <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />NOTICE is present and correct, including copyright date.</li> + <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />All files have license headers where appropriate.</li> + <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />All dependencies have compatible licenses.</li> + <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />No compiled archives bundled in source archive.</li> + <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />I follow this projectâs commits list.</li> </ul> <h2 id="count-the-vote-results">Count the vote results</h2> @@ -504,13 +505,13 @@ warning sign to not proceed if somebody <h2 id="email-the-vote-result">Email the vote result</h2> <p>This is a new email thread with a different subject -(the same as before with <code>[RESULT]</code> prepended).</p> +(the same as before with <code class="language-plaintext highlighter-rouge">[RESULT]</code> prepended).</p> <p>Note that you must find the URL for the previous thread at <a href="https://mail-archives.apache.org/">mail-archives.apache.org</a>.</p> -<h3 id="subject-resultvote-release-apache-brooklyn-versionname-rcrcnumber">Subject: [RESULT][VOTE] Release Apache Brooklyn ${VERSION_NAME} [rc${RC_NUMBER}]</h3> +<h3 id="subject-resultvote-release-apache-brooklyn-version_name-rcrc_number">Subject: [RESULT][VOTE] Release Apache Brooklyn ${VERSION_NAME} [rc${RC_NUMBER}]</h3> -<div class="highlight"><pre><code class="language-text" data-lang="text">The vote for releasing Apache Brooklyn ${VERSION_NAME} passed with 5 binding +1s, 1 non-binding +1s, and no 0 or -1. +<figure class="highlight"><pre><code class="language-text" data-lang="text">The vote for releasing Apache Brooklyn ${VERSION_NAME} passed with 5 binding +1s, 1 non-binding +1s, and no 0 or -1. Vote thread link: https://mail-archives.apache.org/mod_mbox/brooklyn-dev/201507.mbox/%3CCABQFKi1WapCMRUqQ93E7Qow5onKgL3nyG3HW9Cse7vo%2BtUChRQ%40mail.gmail.com%3E @@ -528,7 +529,7 @@ Ciprian Ciubotariu Thanks to everyone that tested our release and voted. Next, the release manager will publish the artifacts, and make an announcement to this list once they are available from -the Apache mirrors.</code></pre></div> +the Apache mirrors.</code></pre></figure> </div> @@ -542,17 +543,17 @@ the Apache mirrors.</code></pre></div> <h4 class=" with_following"> - <a href="/developers/index.html" class="list-group-item breadcrumb breadcrumb0"> + <a href="/developers/" class="list-group-item breadcrumb breadcrumb0"> Developers </a></h4> <h4 class=" with_preceding with_following"> - <a href="/developers/committers/index.html" class="list-group-item breadcrumb breadcrumb1"> + <a href="/developers/committers/" class="list-group-item breadcrumb breadcrumb1"> Committer Guide </a></h4> <h4 class=" with_preceding"> - <a href="/developers/committers/release-process/index.html" class="list-group-item breadcrumb breadcrumb2"> + <a href="/developers/committers/release-process/" class="list-group-item breadcrumb breadcrumb2"> Release Process </a></h4> @@ -818,8 +819,8 @@ the Apache mirrors.</code></pre></div> </div> <div class="col-md-3 text-right"> <p> - <a class="btn btn-sm btn-default" href="https://github.com/apache/brooklyn-docs/edit/website/developers/committers/release-process/vote.md">Edit This Page</a> - <a href="https://brooklyn.apache.org/community/how-to-contribute-docs.html" + <a class="btn btn-sm btn-default" href="https://github.com/apache/brooklyn-docs/edit/master/website/developers/committers/release-process/vote.md">Edit This Page</a> + <a href="/community/how-to-contribute-docs.html" data-toggle="tooltip" data-placement="top" title="" data-delay="400" data-original-title="How to Edit Documentation"> <span class="octicon octicon-question octicon-footer"></span> </a> @@ -858,4 +859,5 @@ the Apache mirrors.</code></pre></div> ZeroClipboard.config({ moviePath: '/style/js/zeroclipboard/ZeroClipboard.swf' }); </script> <script src="/style/js/public.js"></script> + </html>
