Modified: brooklyn/site/developers/committers/release-process/prerequisites.html URL: http://svn.apache.org/viewvc/brooklyn/site/developers/committers/release-process/prerequisites.html?rev=1925014&r1=1925013&r2=1925014&view=diff ============================================================================== --- brooklyn/site/developers/committers/release-process/prerequisites.html (original) +++ brooklyn/site/developers/committers/release-process/prerequisites.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> @@ -365,16 +366,16 @@ <ul> <li>https://dist.apache.org/repos/dist/release/brooklyn - this is where PMC approved releases go. Do not upload here until we have a vote passed on dev@brooklyn. Check out this folder and name it -<code>apache-dist-release-brooklyn</code></li> +<code class="language-plaintext highlighter-rouge">apache-dist-release-brooklyn</code></li> <li>https://dist.apache.org/repos/dist/dev/brooklyn - this is where releases to be voted on go. Make the release artifact, and post it here, then post the [VOTE] thread with links here. Check out this folder and name it -<code>apache-dist-dev-brooklyn</code>.</li> +<code class="language-plaintext highlighter-rouge">apache-dist-dev-brooklyn</code>.</li> </ul> <p>Example:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">svn co https://dist.apache.org/repos/dist/release/brooklyn apache-dist-release-brooklyn -svn co https://dist.apache.org/repos/dist/dev/brooklyn apache-dist-dev-brooklyn</code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash">svn co https://dist.apache.org/repos/dist/release/brooklyn apache-dist-release-brooklyn +svn co https://dist.apache.org/repos/dist/dev/brooklyn apache-dist-dev-brooklyn</code></pre></figure> <p>When working with these folders, <strong>make sure you are working with the correct one</strong>, otherwise you may be publishing pre-release software to the global release mirror network!</p> @@ -385,46 +386,48 @@ pre-release software to the global relea <ul> <li>A Java Development Kit, version 1.8</li> - <li><code>maven</code> and <code>git</code></li> - <li>Go Language 1.6 - usually provided by the <code>golang</code> package on popular distributions</li> - <li>The <code>rpmbuild</code> command - usually provided by the <code>rpm</code> package on popular distributions</li> - <li><code>xmlstarlet</code> is required by the release script to process version numbers in <code>pom.xml</code> files; -on mac, <code>port install xmlstarlet</code> should do the trick.</li> - <li><code>zip</code> and <code>unzip</code></li> - <li><code>gnupg2</code>, and <code>gnupg-agent</code> if it is packaged separately (it is on Ubuntu Linux)</li> - <li><code>pinentry</code> for secure entry of GPG passphrases. If you are building remotely on a Linux machine, <code>pinentry-curses</code> is -recommended; building on a mac, <code>port install pinentry-mac</code> is recommended.</li> - <li>if <code>gpg</code> does not resolve (it is needed for maven), create an alias or script pointing at <code>gpg2 "$@"</code></li> - <li>the <code>mmv</code> command (usually in a package named <code>mmv</code>) will help with the final steps of the release process</li> + <li><code class="language-plaintext highlighter-rouge">maven</code> and <code class="language-plaintext highlighter-rouge">git</code></li> + <li>Go Language 1.6 - usually provided by the <code class="language-plaintext highlighter-rouge">golang</code> package on popular distributions</li> + <li>The <code class="language-plaintext highlighter-rouge">rpmbuild</code> command - usually provided by the <code class="language-plaintext highlighter-rouge">rpm</code> package on popular distributions</li> + <li><code class="language-plaintext highlighter-rouge">xmlstarlet</code> is required by the release script to process version numbers in <code class="language-plaintext highlighter-rouge">pom.xml</code> files; +on mac, <code class="language-plaintext highlighter-rouge">port install xmlstarlet</code> should do the trick.</li> + <li><code class="language-plaintext highlighter-rouge">zip</code> and <code class="language-plaintext highlighter-rouge">unzip</code></li> + <li><code class="language-plaintext highlighter-rouge">gnupg2</code>, and <code class="language-plaintext highlighter-rouge">gnupg-agent</code> if it is packaged separately (it is on Ubuntu Linux)</li> + <li><code class="language-plaintext highlighter-rouge">pinentry</code> for secure entry of GPG passphrases. If you are building remotely on a Linux machine, <code class="language-plaintext highlighter-rouge">pinentry-curses</code> is +recommended; building on a mac, <code class="language-plaintext highlighter-rouge">port install pinentry-mac</code> is recommended.</li> + <li><code class="language-plaintext highlighter-rouge">md5sum</code> and <code class="language-plaintext highlighter-rouge">sha1sum</code> - these are often present by default on Linux, but not on Mac; +<code class="language-plaintext highlighter-rouge">port install md5sha1sum</code> should remedy that.</li> + <li>if <code class="language-plaintext highlighter-rouge">gpg</code> does not resolve (it is needed for maven), create an alias or script pointing at <code class="language-plaintext highlighter-rouge">gpg2 "$@"</code></li> + <li>the <code class="language-plaintext highlighter-rouge">mmv</code> command (usually in a package named <code class="language-plaintext highlighter-rouge">mmv</code>) will help with the final steps of the release process</li> </ul> <h2 id="gpg-keys">GPG keys</h2> -<p>The release manager must have a GPG key to be used to sign the release. See below to install <code>gpg2</code> -(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> +<p>The release manager must have a GPG key to be used to sign the release. See below to install <code class="language-plaintext highlighter-rouge">gpg2</code> +(with a <code class="language-plaintext highlighter-rouge">gpg</code> alias). The steps here also assume you have the following set +(not using <code class="language-plaintext highlighter-rouge">whoami</code> if thatâs not appropriate):</p> -<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> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nv">ASF_USERNAME</span><span class="o">=</span><span class="sb">`</span><span class="nb">whoami</span><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> +<span class="nv">SVN_USERNAME</span><span class="o">=</span><span class="nv">$ASF_USERNAME</span></code></pre></figure> <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 -Apache email address, using <code>gpg2 --gen-key</code> then <code>gpg2 --export-key $GPG_KEY > my-apache.key</code> and -<code>gpg2 --export-secret-key -a $GPG_KEY > my-apache.private.key</code> in the right directory (<code>~/.ssh</code> is a good one).</p> +Apache email address, using <code class="language-plaintext highlighter-rouge">gpg2 --gen-key</code> then <code class="language-plaintext highlighter-rouge">gpg2 --export-key $GPG_KEY > my-apache.key</code> and +<code class="language-plaintext highlighter-rouge">gpg2 --export-secret-key -a $GPG_KEY > my-apache.private.key</code> in the right directory (<code class="language-plaintext highlighter-rouge">~/.ssh</code> is a good one).</p> <p>Upload your GPG public key (complete with your Apache email address on it) to a public keyserver - e.g. run -<code>gpg2 --export --armor $GPG_KEY</code> and paste it into the âsubmitâ box on http://pgp.mit.edu/</p> +<code class="language-plaintext highlighter-rouge">gpg2 --export --armor $GPG_KEY</code> and paste it into the âsubmitâ box on http://pgp.mit.edu/</p> -<p>Look up your key fingerprint with <code>gpg2 --fingerprint $GPG_KEY</code> - itâs the long sequence of hex numbers +<p>Look up your key fingerprint with <code class="language-plaintext highlighter-rouge">gpg2 --fingerprint $GPG_KEY</code> - itâs the long sequence of hex numbers separated by spaces. Log in to <a href="https://id.apache.org/";>https://id.apache.org/</a> then copy-and-paste the fingerprint into âOpenPGP Public Key Primary Fingerprintâ. Submit.</p> -<p>Now add your key to the <code>apache-dist-release-brooklyn/KEYS</code> file:</p> +<p>Now add your key to the <code class="language-plaintext highlighter-rouge">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 <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> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd </span>apache-dist-release-brooklyn +<span class="o">(</span>gpg2 <span class="nt">--list-sigs</span> <span class="nv">$ASF_USERNAME</span>@apache.org <span class="o">&&</span> gpg2 <span class="nt">--armor</span> <span class="nt">--export</span> <span class="nv">$ASF_USERNAME</span>@apache.org<span class="o">)</span> <span class="o">>></span> KEYS +svn <span class="nt">--username</span> <span class="nv">$SVN_USERNAME</span> <span class="nt">--no-auth-cache</span> commit <span class="nt">-m</span> <span class="s2">"Update brooklyn/KEYS for </span><span class="nv">$GPG_KEY</span><span class="s2">"</span></code></pre></figure> <p>References:</p> @@ -433,17 +436,17 @@ svn --username <span class="nv">$SVN_USE <li><a href="http://irtfweb.ifa.hawaii.edu/~lockhart/gpg/gpg-cs.html";>GPG cheatsheet</a></li> </ul> -<p>We recommend the use of the <code>gpg-agent</code>, as the release process invokes gpg to sign a large number of artifacts, one at -a time. The agent stores its configuration in <code>~/.gnupg/gpg-agent.conf</code>. A sample configuration is shown below; it uses -the Mac OSX <code>pinentry-mac</code> program which can be obtained through MacPorts or other sources. For other platforms you will +<p>We recommend the use of the <code class="language-plaintext highlighter-rouge">gpg-agent</code>, as the release process invokes gpg to sign a large number of artifacts, one at +a time. The agent stores its configuration in <code class="language-plaintext highlighter-rouge">~/.gnupg/gpg-agent.conf</code>. A sample configuration is shown below; it uses +the Mac OSX <code class="language-plaintext highlighter-rouge">pinentry-mac</code> program which can be obtained through MacPorts or other sources. For other platforms you will need to change this; sometimes you can omit it completely and your OS will pick a suitable alternative. The following two lines cause your passphrase to be cached in memory for a limited period; it will expire from the cache 30 minutes -after it was most recently accessed, or 4 hours after it was first cached. </p> +after it was most recently accessed, or 4 hours after it was first cached.</p> -<pre><code>pinentry-program /Applications/MacPorts/pinentry-mac.app/Contents/MacOS/pinentry-mac +<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>pinentry-program /Applications/MacPorts/pinentry-mac.app/Contents/MacOS/pinentry-mac default-cache-ttl 1800 max-cache-ttl 14400 -</code></pre> +</code></pre></div></div> <p>If you experience trouble with PGP subsequently (when running maven):</p> @@ -457,12 +460,12 @@ max-cache-ttl 14400 <p>The release will involve uploading artifacts to Apacheâs Nexus instance - therefore you will need to configure your Maven install with the necessary credentials.</p> -<p>You will need to add something like this to your <code>~/.m2/settings.xml</code> file:</p> +<p>You will need to add something like this to your <code class="language-plaintext highlighter-rouge">~/.m2/settings.xml</code> file:</p> -<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="cp"><?xml version="1.0"?></span> -<span class="nt"><settings</span> <span class="na">xsi:schemaLocation=</span><span class="s">"http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd"</span> - <span class="na">xmlns=</span><span class="s">"http://maven.apache.org/SETTINGS/1.1.0"</span> - <span class="na">xmlns:xsi=</span><span class="s">"http://www.w3.org/2001/XMLSchema-instance"</span><span class="nt">></span> +<figure class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="cp"><?xml version="1.0"?></span> +<span class="nt"><settings</span> <span class="na">xsi:schemaLocation=</span><span class="s">"http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd";</span> + <span class="na">xmlns=</span><span class="s">"http://maven.apache.org/SETTINGS/1.1.0";</span> + <span class="na">xmlns:xsi=</span><span class="s">"http://www.w3.org/2001/XMLSchema-instance";</span><span class="nt">></span> <span class="c"><!-- ... --></span> @@ -470,8 +473,8 @@ Maven install with the necessary credent <span class="c"><!-- ... --></span> - <span class="c"><!-- Required for uploads to Apache's Nexus instance. These are LDAP credentials - the same credentials you</span> -<span class="c"> - would use to log in to Git and Jenkins (but not JIRA) --></span> + <span class="c"><!-- Required for uploads to Apache's Nexus instance. These are LDAP credentials - the same credentials you + - would use to log in to Git and Jenkins (but not JIRA) --></span> <span class="nt"><server></span> <span class="nt"><id></span>apache.snapshots.https<span class="nt"></id></span> <span class="nt"><username></span>xxx<span class="nt"></username></span> @@ -489,7 +492,7 @@ Maven install with the necessary credent <span class="c"><!-- ... --></span> -<span class="nt"></settings></span></code></pre></div> +<span class="nt"></settings></span></code></pre></figure> </div> @@ -503,17 +506,17 @@ Maven install with the necessary credent <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> @@ -779,8 +782,8 @@ Maven install with the necessary credent </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/prerequisites.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/prerequisites.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> @@ -819,4 +822,5 @@ Maven install with the necessary credent ZeroClipboard.config({ moviePath: '/style/js/zeroclipboard/ZeroClipboard.swf' }); </script> <script src="/style/js/public.js"></script> + </html>
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=1925014&r1=1925013&r2=1925014&view=diff ============================================================================== --- brooklyn/site/developers/committers/release-process/publish-temp.html (original) +++ brooklyn/site/developers/committers/release-process/publish-temp.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> @@ -360,30 +361,30 @@ <p>Make a signed tag for this release candidate:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> m in <span class="k">${</span><span class="nv">MODULES</span><span class="k">}</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 tag -s -m <span class="s2">"Tag release ${VERSION_NAME} release candidate ${RC_NUMBER}"</span> rel/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="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="k">${</span><span class="nv">MODULES</span><span class="k">}</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 tag <span class="nt">-s</span> <span class="nt">-m</span> <span class="s2">"Tag release </span><span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span><span class="s2"> release candidate </span><span class="k">${</span><span class="nv">RC_NUMBER</span><span class="k">}</span><span class="s2">"</span> rel/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="o">)</span><span class="p">;</span> <span class="k">done</s pan></code></pre></figure> <p>Now push the release branch and release candidate tag:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> m in <span class="k">${</span><span class="nv">MODULES</span><span class="k">}</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> git push apache-git rel/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="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="k">${</span><span class="nv">MODULES</span><span class="k">}</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> git push apache-git rel/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="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></figure> <h2 id="publish-the-source-and-binary-distributions-to-the-pre-release-area">Publish the source and binary distributions to the pre-release area</h2> <p>You will need to have checked out the Apache distribution Subversion repository located at -https://dist.apache.org/repos/dist/dev/brooklyn. Please refer to <a href="prerequisites.html">Prerequisites</a> for +https://dist.apache.org/repos/dist/dev/brooklyn. Please refer to <a href="/developers/committers/release-process/prerequisites.html">Prerequisites</a> for information.</p> -<p>In your workspace for the <code>dist.apache.org</code> repo, create a directory with the artifact name and version:</p> +<p>In your workspace for the <code class="language-plaintext highlighter-rouge">dist.apache.org</code> repo, create a directory with the artifact name and version:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">mkdir 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></code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">mkdir </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></code></pre></figure> -<p>Copy into this directory all of the artifacts from the previous step - <code>-src</code> and <code>-bin</code>, <code>.tar.gz</code>, <code>.zip</code> and <code>.rpm</code>, -and all associated <code>.sha256</code> and <code>.asc</code> signatures. Then commit:</p> +<p>Copy into this directory all of the artifacts from the previous step - <code class="language-plaintext highlighter-rouge">-src</code> and <code class="language-plaintext highlighter-rouge">-bin</code>, <code class="language-plaintext highlighter-rouge">.tar.gz</code>, <code class="language-plaintext highlighter-rouge">.zip</code> and <code class="language-plaintext highlighter-rouge">.rpm</code>, +and all associated <code class="language-plaintext highlighter-rouge">.md5</code>, <code class="language-plaintext highlighter-rouge">.sha1</code>, <code class="language-plaintext highlighter-rouge">.sha256</code> and <code class="language-plaintext highlighter-rouge">.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 --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> +<figure 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><span class="nt">-rc</span><span class="k">${</span><span class="nv">RC_NUMBER</span><span class="k">}</span> +svn commit <span class="nt">--username</span> <span class="nv">$SVN_USERNAME</span> <span class="nt">--no-auth-cache</span> <span class="nt">--message</span> <span class="s2">"Add apache-brooklyn-</span><span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span><span class="s2">-rc</span><span class="k">${</span><span class="nv">RC_NUMBER</span><span class="k">}</span><span class="s2"> to dist/dev/brooklyn"</span></code></pre></figure> -<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> +<p>These steps can be performed as part of the <code class="language-plaintext highlighter-rouge">make-release-artifacts.sh</code> script used earlier +if <code class="language-plaintext highlighter-rouge">${APACHE_DIST_SVN_DIR}</code> points to the appropriate subversion directory.</p> <h2 id="close-the-staging-repository-on-apaches-nexus-server">Close the staging repository on Apacheâs Nexus server</h2> @@ -392,8 +393,8 @@ 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.10.0-rc1</code>.</p> +Repositoriesâ page, and tick the repository with the name starting <code class="language-plaintext highlighter-rouge">orgapachebrooklyn</code>. Click the <strong>Close</strong> button. +Provide a description which includes the version and release candidate, e.g. <code class="language-plaintext highlighter-rouge">Apache Brooklyn 0.10.0-rc1</code>.</p> </div> @@ -406,17 +407,17 @@ Provide a description which includes the <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> @@ -682,8 +683,8 @@ Provide a description which includes the </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/publish-temp.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/publish-temp.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> @@ -722,4 +723,5 @@ Provide a description which includes the ZeroClipboard.config({ moviePath: '/style/js/zeroclipboard/ZeroClipboard.swf' }); </script> <script src="/style/js/public.js"></script> + </html> Modified: brooklyn/site/developers/committers/release-process/publish.html URL: http://svn.apache.org/viewvc/brooklyn/site/developers/committers/release-process/publish.html?rev=1925014&r1=1925013&r2=1925014&view=diff ============================================================================== --- brooklyn/site/developers/committers/release-process/publish.html (original) +++ brooklyn/site/developers/committers/release-process/publish.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> @@ -360,64 +361,66 @@ <p>Make a signed tag for this release:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> m in <span class="k">${</span><span class="nv">MODULES</span><span class="k">}</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 tag -s -m <span class="s2">"Tag release ${VERSION_NAME}"</span> rel/apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span> rel/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="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="k">${</span><span class="nv">MODULES</span><span class="k">}</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 tag <span class="nt">-s</span> <span class="nt">-m</span> <span class="s2">"Tag release </span><span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span><span class="s2">"</span> rel/apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span> rel/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="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></ figure> <p>Now push the release tag:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for</span> m in <span class="k">${</span><span class="nv">MODULES</span><span class="k">}</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 rel/apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</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="k">${</span><span class="nv">MODULES</span><span class="k">}</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 rel/apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span> <span class="o">)</span><span class="p">;</span> <span class="k">done</span></code></pre></figure> <h2 id="publish-the-source-and-binary-distributions-to-the-pre-release-area">Publish the source and binary distributions to the pre-release area</h2> <p>You will need to have checked out the Apache distribution Subversion repository located at -https://dist.apache.org/repos/dist/release/brooklyn. Please refer to <a href="prerequisites.html">Prerequisites</a> for +https://dist.apache.org/repos/dist/release/brooklyn. Please refer to <a href="/developers/committers/release-process/prerequisites.html">Prerequisites</a> for information.</p> -<p>In your workspace for the <code>dist.apache.org</code> repo, create a directory with the artifact name and version:</p> +<p>In your workspace for the <code class="language-plaintext highlighter-rouge">dist.apache.org</code> repo, create a directory with the artifact name and version:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">mkdir apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span></code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">mkdir </span>apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span></code></pre></figure> -<p>Refer back to the pre-release area Subversion (see <a href="publish-temp.html">Publish to the staging area</a>), and copy all of -the release candidate artifacts - <code>-src</code> and <code>-bin</code>, <code>.tar.gz</code> and <code>.zip</code>, and all associated <code>.sha256</code> -and <code>.asc</code> signatures - into this new folder.</p> +<p>Refer back to the pre-release area Subversion (see <a href="/developers/committers/release-process/publish-temp.html">Publish to the staging area</a>), and copy all of +the release candidate artifacts - <code class="language-plaintext highlighter-rouge">-src</code> and <code class="language-plaintext highlighter-rouge">-bin</code>, <code class="language-plaintext highlighter-rouge">.tar.gz</code> and <code class="language-plaintext highlighter-rouge">.zip</code>, and all associated <code class="language-plaintext highlighter-rouge">.md5</code>, <code class="language-plaintext highlighter-rouge">.sha1</code>, <code class="language-plaintext highlighter-rouge">.sha256</code> +and <code class="language-plaintext highlighter-rouge">.asc</code> signatures - into this new folder.</p> -<p>Rename all of the files to remove the <code>-rcN</code> designation:</p> +<p>Rename all of the files to remove the <code class="language-plaintext highlighter-rouge">-rcN</code> designation:</p> -<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> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="k">for </span>f <span class="k">in</span> <span class="k">*</span><span class="p">;</span> <span class="k">do </span><span class="nb">mv</span> <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></figure> -<p>The hash files will need patching to refer to the filenames without the <code>-rcN</code> designation:</p> +<p>The hash files will need patching to refer to the filenames without the <code class="language-plaintext highlighter-rouge">-rcN</code> designation:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">sed -i.bak <span class="s1">'s/-rc'</span><span class="nv">$RC_NUMBER</span><span class="s1">'-/-/'</span> *.sha256 -rm -f *.bak</code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">sed</span> <span class="nt">-i</span>.bak <span class="s1">'s/-rc'</span><span class="nv">$RC_NUMBER</span><span class="s1">'-/-/'</span> <span class="k">*</span>.md5 <span class="k">*</span>.sha1 <span class="k">*</span>.sha256 +<span class="nb">rm</span> <span class="nt">-f</span> <span class="k">*</span>.bak</code></pre></figure> <p>Note that the PGP signatures do not embed the filename so they do not need to be modified</p> <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 <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> -<p>(You may get warnings such as: <code>gpg: WARNING: This key is not certified with a trusted signature!</code> -and <code>There is no indication that the signature belongs to the owner.</code> This happens if you have not trusted +<p>(You may get warnings such as: <code class="language-plaintext highlighter-rouge">gpg: WARNING: This key is not certified with a trusted signature!</code> +and <code class="language-plaintext highlighter-rouge">There is no indication that the signature belongs to the owner.</code> This happens if you have not trusted the personâs key. A key-signing party is a good way to extend this web of trust).</p> <p>Then, add them to Subversion and 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> -svn commit --message <span class="s2">"Add apache-brooklyn-${VERSION_NAME} to dist/release/brooklyn"</span></code></pre></div> +<figure 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> +svn commit <span class="nt">--message</span> <span class="s2">"Add apache-brooklyn-</span><span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span><span class="s2"> to dist/release/brooklyn"</span></code></pre></figure> <h2 id="publish-the-staging-repository-on-apaches-nexus-server">Publish the staging repository on Apacheâs Nexus server</h2> <p><em>Releasing</em> the staging repository causes its contents to be copied to the main Apache Nexus repository. This in turn is propagated to Maven Central, meaning all of our users can access the artifacts using a default Maven configuration -(thereâs no need to add a <code><repository></code> to their <code>pom.xml</code> or <code>~/.m2/settings.xml</code>).</p> +(thereâs no need to add a <code class="language-plaintext highlighter-rouge"><repository></code> to their <code class="language-plaintext highlighter-rouge">pom.xml</code> or <code class="language-plaintext highlighter-rouge">~/.m2/settings.xml</code>).</p> <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>Release</strong> button. -Provide a description which includes the version, e.g. <code>Apache Brooklyn 0.7.0-incubating</code>.</p> +Repositoriesâ page, and tick the repository with the name starting <code class="language-plaintext highlighter-rouge">orgapachebrooklyn</code>. Click the <strong>Release</strong> button. +Provide a description which includes the version, e.g. <code class="language-plaintext highlighter-rouge">Apache Brooklyn 0.7.0-incubating</code>.</p> <p>Note there is only one orgapachebrooklyn staging repository at a time; this will be the one created for the release candidate with whatever name was used there (e.g. it might include ârcâ in the name). If you really want, you can @@ -432,46 +435,46 @@ double-check under the âcontentâ <p>Go to the release branch and perform a build:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">git checkout <span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span> -mvn clean install -DskipTests</code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash">git checkout <span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span> +mvn clean <span class="nb">install</span> <span class="nt">-DskipTests</span></code></pre></figure> <p>Ensure the SVN repo is up-to-date (very painful otherwise!)</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd</span> <span class="k">${</span><span class="nv">BROOKLYN_SITE_DIR</span><span class="p">-../brooklyn-site-public</span><span class="k">}</span> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd</span> <span class="k">${</span><span class="nv">BROOKLYN_SITE_DIR</span><span class="p">-../brooklyn-site-public</span><span class="k">}</span> svn up -<span class="nb">cd</span> -</code></pre></div> +<span class="nb">cd</span> -</code></pre></figure> <p>Generate the permalink docs for the release:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd </span>brooklyn-docs -./_build/build.sh guide-version --install</code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd </span>brooklyn-docs +./_build/build.sh guide-version <span class="nt">--install</span></code></pre></figure> <p>Now publish _site/v/<em>${VERSION_NAME}</em> to the public website.</p> <p>Update the âlatestâ docs to this release:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">./_build/build.sh guide-latest --install</code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash">./_build/build.sh guide-latest <span class="nt">--install</span></code></pre></figure> <p>Now publish _site/v/latest to the public website:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd</span> <span class="k">${</span><span class="nv">BROOKLYN_SITE_DIR</span><span class="p">-../../brooklyn-site-public</span><span class="k">}</span> -svn add * --force -<span class="nb">export </span><span class="nv">DELETIONS</span><span class="o">=</span><span class="k">$(</span> svn status <span class="p">|</span> sed -e <span class="s1">'/^!/!d'</span> -e <span class="s1">'s/^!//'</span> <span class="k">)</span> -<span class="k">if</span> <span class="o">[</span> ! -z <span class="s2">"${DELETIONS}"</span> <span class="o">]</span> <span class="p">;</span> <span class="k">then</span> svn rm <span class="k">${</span><span class="nv">DELETIONS</span><span class="k">}</span> <span class="p">;</span> <span class="k">fi</span></code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nb">cd</span> <span class="k">${</span><span class="nv">BROOKLYN_SITE_DIR</span><span class="p">-../../brooklyn-site-public</span><span class="k">}</span> +svn add <span class="k">*</span> <span class="nt">--force</span> +<span class="nb">export </span><span class="nv">DELETIONS</span><span class="o">=</span><span class="si">$(</span> svn status | <span class="nb">sed</span> <span class="nt">-e</span> <span class="s1">'/^!/!d'</span> <span class="nt">-e</span> <span class="s1">'s/^!//'</span> <span class="si">)</span> +<span class="k">if</span> <span class="o">[</span> <span class="o">!</span> <span class="nt">-z</span> <span class="s2">"</span><span class="k">${</span><span class="nv">DELETIONS</span><span class="k">}</span><span class="s2">"</span> <span class="o">]</span> <span class="p">;</span> <span class="k">then </span>svn <span class="nb">rm</span> <span class="k">${</span><span class="nv">DELETIONS</span><span class="k">}</span> <span class="p">;</span> <span class="k">fi</span></code></pre></figure> <h3 id="update-the-main-website-to-link-to-the-new-release">Update the main website to link to the new release</h3> -<p>This should be done on the <code>master</code> branch:</p> +<p>This should be done on the <code class="language-plaintext highlighter-rouge">master</code> branch:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">git checkout master</code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash">git checkout master</code></pre></figure> <ol> - <li>Edit the file <code>brooklyn-docs/_config.yml</code> - change <code>brooklyn-stable-version</code> to be the newly-release version, and -<code>brooklyn-version</code> to be the current SNAPSHOT version on the master branch.</li> - <li>Edit the file <code>brooklyn-docs/website/download/verify.md</code> to add links to the SHA256 hashes and PGP signatures for the + <li>Edit the file <code class="language-plaintext highlighter-rouge">brooklyn-docs/_config.yml</code> - change <code class="language-plaintext highlighter-rouge">brooklyn-stable-version</code> to be the newly-release version, and +<code class="language-plaintext highlighter-rouge">brooklyn-version</code> to be the current SNAPSHOT version on the master branch.</li> + <li>Edit the file <code class="language-plaintext highlighter-rouge">brooklyn-docs/website/download/verify.md</code> to add links to the MD5/SHA1/SHA256 hashes and PGP signatures for the new version.</li> - <li>Edit the file <code>brooklyn-docs/website/meta/versions.md</code> to add the new version.</li> - <li>Build the updated site with <code>./_build/build.sh website-root --install</code>.</li> + <li>Edit the file <code class="language-plaintext highlighter-rouge">brooklyn-docs/website/meta/versions.md</code> to add the new version.</li> + <li>Build the updated site with <code class="language-plaintext highlighter-rouge">./_build/build.sh website-root --install</code>.</li> <li>Publish to the public website.</li> <li>Commit your changes to master, e.g. with a message like âUpdate latest docs to 0.8.0-incubatingâ</li> </ol> @@ -480,11 +483,11 @@ new version.</li> <p>Make a signed tag for this release, based on the tag for the release candidate, and then push the tag:</p> -<div class="highlight"><pre><code class="language-bash" data-lang="bash">git tag -s -m <span class="s2">"Tag release ${VERSION_NAME}"</span> apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</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> -git push apache apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span></code></pre></div> +<figure class="highlight"><pre><code class="language-bash" data-lang="bash">git tag <span class="nt">-s</span> <span class="nt">-m</span> <span class="s2">"Tag release </span><span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span><span class="s2">"</span> apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</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> +git push apache apache-brooklyn-<span class="k">${</span><span class="nv">VERSION_NAME</span><span class="k">}</span></code></pre></figure> -<p>Note the tag <code>apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER}</code> should have been created as part of the -RC creation - see <a href="make-release-artifacts.html">make-release-artifacts</a>.</p> +<p>Note the tag <code class="language-plaintext highlighter-rouge">apache-brooklyn-${VERSION_NAME}-rc${RC_NUMBER}</code> should have been created as part of the +RC creation - see <a href="/developers/committers/release-process/make-release-artifacts.html">make-release-artifacts</a>.</p> </div> @@ -498,17 +501,17 @@ RC creation - see <a href="make-release- <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> @@ -774,8 +777,8 @@ RC creation - see <a href="make-release- </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/publish.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/publish.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> @@ -814,4 +817,5 @@ RC creation - see <a href="make-release- ZeroClipboard.config({ moviePath: '/style/js/zeroclipboard/ZeroClipboard.swf' }); </script> <script src="/style/js/public.js"></script> + </html>
