devel/development/release.html - arrow-flight-sql-postgresql - Git at Google


 <!DOCTYPE html>


 <html lang="en" data-content_root="../" >

   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />

     <title>Release &#8212; Apache Arrow Flight SQL adapter for PostgreSQL devel documentation</title>


   <script data-cfasync="false">
     document.documentElement.dataset.mode = localStorage.getItem("mode") || "";
     document.documentElement.dataset.theme = localStorage.getItem("theme") || "";
   </script>
   <!--
     this give us a css class that will be invisible only if js is disabled
   -->
   <noscript>
     <style>
       .pst-js-only { display: none !important; }

     </style>
   </noscript>

   <!-- Loaded before other Sphinx assets -->
   <link href="../_static/styles/theme.css?digest=90905a2f556bf617f1a9" rel="stylesheet" />
 <link href="../_static/styles/pydata-sphinx-theme.css?digest=90905a2f556bf617f1a9" rel="stylesheet" />

     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=8f2a1f02" />
     <link rel="stylesheet" type="text/css" href="../_static/tabs.css?v=4c969af8" />

   <!-- So that users can add custom icons -->
   <script defer src="../_static/scripts/fontawesome.js?digest=90905a2f556bf617f1a9"></script>
   <!-- Pre-loaded scripts that we'll load fully later -->
   <link rel="preload" as="script" href="../_static/scripts/bootstrap.js?digest=90905a2f556bf617f1a9" />
 <link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=90905a2f556bf617f1a9" />

     <script src="../_static/documentation_options.js?v=1dba82e2"></script>
     <script src="../_static/doctools.js?v=fd6eb6e6"></script>
     <script src="../_static/sphinx_highlight.js?v=6ffebe34"></script>
     <script src="../_static/tabs.js?v=3ee01567"></script>
     <script>DOCUMENTATION_OPTIONS.pagename = 'development/release';</script>
     <script>
         DOCUMENTATION_OPTIONS.theme_version = '0.20.0';
         DOCUMENTATION_OPTIONS.theme_switcher_json_url = 'https://arrow.apache.org/flight-sql-postgresql/devel/_static/switcher.json';
         DOCUMENTATION_OPTIONS.theme_switcher_version_match = 'devel';
         DOCUMENTATION_OPTIONS.show_version_warning_banner =
             false;
         </script>
     <script>DOCUMENTATION_OPTIONS.search_as_you_type = false;</script>
     <link rel="icon" href="../_static/favicon.ico"/>
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />
     <link rel="prev" title="Client" href="../client.html" />
   <meta name="viewport" content="width=device-width, initial-scale=1"/>
   <meta name="docsearch:language" content="en"/>
   <meta name="docsearch:version" content="0.2.0" />


     <script src="../_static/searchtools.js"></script>
     <script src="../_static/language_data.js"></script>
     <script src="../searchindex.js"></script>

   </head>
   <body data-default-mode="">


   <div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Skip to main content</a></div>


   <div id="pst-scroll-pixel-helper"></div>

   <button type="button" class="btn rounded-pill" id="pst-back-to-top">
     <i class="fa-solid fa-arrow-up"></i>Back to top</button>


   <dialog id="pst-search-dialog">

 <form class="bd-search d-flex align-items-center"
       action="../search.html"
       method="get">
   <i class="fa-solid fa-magnifying-glass"></i>
   <input type="search"
          class="form-control"
          name="q"
          placeholder="Search the docs ..."
          aria-label="Search the docs ..."
          autocomplete="off"
          autocorrect="off"
          autocapitalize="off"
          spellcheck="false"/>
   <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>
 </form>
   </dialog>

   <div class="pst-async-banner-revealer d-none">
   <aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Version warning"></aside>
 </div>


     <header id="pst-header" class="bd-header navbar navbar-expand-lg bd-navbar d-print-none">
 <div class="bd-header__inner bd-page-width">
   <button class="pst-navbar-icon sidebar-toggle primary-toggle" aria-label="Site navigation">
     <span class="fa-solid fa-bars"></span>
   </button>


   <div class="col-lg-3 navbar-header-items__start">

       <div class="navbar-item">


 <a class="navbar-brand logo" href="../index.html">


     <img src="../_static/logo-light.png" class="logo__image only-light" alt="Apache Arrow Flight SQL adapter for PostgreSQL"/>
     <img src="../_static/logo-dark.png" class="logo__image only-dark pst-js-only" alt="Apache Arrow Flight SQL adapter for PostgreSQL"/>


 </a></div>

   </div>

   <div class="col-lg-9 navbar-header-items">


     <div class="navbar-header-items__end">

         <div class="navbar-item navbar-persistent--container">


 <button class="btn search-button-field search-button__button pst-js-only" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
  <i class="fa-solid fa-magnifying-glass"></i>
  <span class="search-button__default-text">Search</span>
  <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
 </button>
         </div>


         <div class="navbar-item">

 <div class="theme-switch-container dropdown pst-js-only" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Color mode">
   <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button dropdown-toggle" aria-label="Color mode" data-bs-toggle="dropdown">
     <i class="theme-switch fa-solid fa-sun fa-lg fa-fw" data-mode="light" title="Light"></i>
     <i class="theme-switch fa-solid fa-moon fa-lg fa-fw" data-mode="dark" title="Dark"></i>
     <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg fa-fw" data-mode="auto" title="System Settings"></i>
   </button>
   <ul class="dropdown-menu dropdown-menu-end">
     <li><button class="dropdown-item d-flex align-items-center theme-change-button" data-mode="auto"><i class="fa-solid fa-circle-half-stroke fa-lg fa-fw me-1"></i>System Settings</button></li>
     <li><button class="dropdown-item d-flex align-items-center theme-change-button" data-mode="light"><i class="fa-solid fa-sun fa-lg fa-fw me-1"></i>Light</button></li>
     <li><button class="dropdown-item d-flex align-items-center theme-change-button" data-mode="dark"><i class="fa-solid fa-moon fa-lg fa-fw me-1"></i>Dark</button></li>
   </ul>
 </div></div>

         <div class="navbar-item"><ul class="navbar-icon-links"
     aria-label="Icon Links">
         <li class="nav-item">


           <a href="https://github.com/apache/arrow-flight-sql-postgresql" title="GitHub" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-square-github fa-lg" aria-hidden="true"></i><span class="visually-hidden">GitHub</span></a>
         </li>
 </ul></div>

         <div class="navbar-item">
 <div class="version-switcher__container dropdown pst-js-only">
   <button id="pst-version-switcher-button-2"
     type="button"
     class="version-switcher__button btn btn-sm dropdown-toggle"
     data-bs-toggle="dropdown"
     aria-haspopup="listbox"
     aria-controls="pst-version-switcher-list-2"
     aria-label="Version switcher list"
   >
     Choose version  <!-- this text may get changed later by javascript -->
     <span class="caret"></span>
   </button>
   <div id="pst-version-switcher-list-2"
     class="version-switcher__menu dropdown-menu list-group-flush py-0"
     role="listbox" aria-labelledby="pst-version-switcher-button-2">
     <!-- dropdown will be populated by javascript on page load -->
   </div>
 </div></div>

     </div>

   </div>


     <div class="navbar-persistent--mobile">

 <button class="btn search-button-field search-button__button pst-js-only" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">
  <i class="fa-solid fa-magnifying-glass"></i>
  <span class="search-button__default-text">Search</span>
  <span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd class="kbd-shortcut__modifier">K</kbd></span>
 </button>
     </div>


     <button class="pst-navbar-icon sidebar-toggle secondary-toggle" aria-label="On this page">
       <span class="fa-solid fa-outdent"></span>
     </button>

 </div>

     </header>


   <div class="bd-container">
     <div class="bd-container__inner bd-page-width">


       <dialog id="pst-primary-sidebar-modal"></dialog>
       <div id="pst-primary-sidebar" class="bd-sidebar-primary bd-sidebar">


   <div class="sidebar-header-items sidebar-primary__section">


       <div class="sidebar-header-items__end">

           <div class="navbar-item">

 <div class="theme-switch-container dropdown pst-js-only" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Color mode">
   <button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button dropdown-toggle" aria-label="Color mode" data-bs-toggle="dropdown">
     <i class="theme-switch fa-solid fa-sun fa-lg fa-fw" data-mode="light" title="Light"></i>
     <i class="theme-switch fa-solid fa-moon fa-lg fa-fw" data-mode="dark" title="Dark"></i>
     <i class="theme-switch fa-solid fa-circle-half-stroke fa-lg fa-fw" data-mode="auto" title="System Settings"></i>
   </button>
   <ul class="dropdown-menu dropdown-menu-end">
     <li><button class="dropdown-item d-flex align-items-center theme-change-button" data-mode="auto"><i class="fa-solid fa-circle-half-stroke fa-lg fa-fw me-1"></i>System Settings</button></li>
     <li><button class="dropdown-item d-flex align-items-center theme-change-button" data-mode="light"><i class="fa-solid fa-sun fa-lg fa-fw me-1"></i>Light</button></li>
     <li><button class="dropdown-item d-flex align-items-center theme-change-button" data-mode="dark"><i class="fa-solid fa-moon fa-lg fa-fw me-1"></i>Dark</button></li>
   </ul>
 </div></div>

           <div class="navbar-item"><ul class="navbar-icon-links"
     aria-label="Icon Links">
         <li class="nav-item">


           <a href="https://github.com/apache/arrow-flight-sql-postgresql" title="GitHub" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-square-github fa-lg" aria-hidden="true"></i><span class="visually-hidden">GitHub</span></a>
         </li>
 </ul></div>

           <div class="navbar-item">
 <div class="version-switcher__container dropdown pst-js-only">
   <button id="pst-version-switcher-button-3"
     type="button"
     class="version-switcher__button btn btn-sm dropdown-toggle"
     data-bs-toggle="dropdown"
     aria-haspopup="listbox"
     aria-controls="pst-version-switcher-list-3"
     aria-label="Version switcher list"
   >
     Choose version  <!-- this text may get changed later by javascript -->
     <span class="caret"></span>
   </button>
   <div id="pst-version-switcher-list-3"
     class="version-switcher__menu dropdown-menu list-group-flush py-0"
     role="listbox" aria-labelledby="pst-version-switcher-button-3">
     <!-- dropdown will be populated by javascript on page load -->
   </div>
 </div></div>

       </div>

   </div>

     <div class="sidebar-primary-items__start sidebar-primary__section">
         <div class="sidebar-primary-item pst-sidebar-collapse"><button id="pst-collapse-sidebar-button" aria-expanded="true" aria-controls="pst-primary-sidebar">
   <svg class="pst-icon" role="img" aria-hidden="true" focusable="false" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg">
     <path fill="currentColor" d="M3 15.5C2.36232 15.5 1.74874 15.2564 1.28478 14.8189C0.820828 14.3815 0.541576 13.7832 0.504167 13.1467L0.5 13L0.5 3C0.499965 2.36232 0.743605 1.74874 1.18107 1.28478C1.61854 0.820828 2.21676 0.541576 2.85333 0.504167L3 0.5L13 0.5C13.6377 0.499965 14.2513 0.743605 14.7152 1.18107C15.1792 1.61854 15.4584 2.21676 15.4958 2.85333L15.5 3L15.5 13C15.5 13.6377 15.2564 14.2513 14.8189 14.7152C14.3815 15.1792 13.7832 15.4584 13.1467 15.4958L13 15.5L3 15.5ZM3 13.8333L10.5 13.8333L10.5 2.16667L3 2.16667C2.79589 2.16669 2.59889 2.24163 2.44636 2.37726C2.29383 2.5129 2.19638 2.69979 2.1725 2.9025L2.16667 3L2.16667 13C2.16669 13.2041 2.24163 13.4011 2.37726 13.5536C2.5129 13.7062 2.69979 13.8036 2.9025 13.8275L3 13.8333ZM6.65583 10.325L6.5775 10.2558L4.91083 8.58917C4.76735 8.44567 4.68116 8.25476 4.66843 8.05223C4.65569 7.84971 4.71729 7.6495 4.84167 7.48917L4.91083 7.41083L6.5775 5.74417C6.72747 5.59471 6.9287 5.50794 7.14032 5.50148C7.35194 5.49502 7.55809 5.56935 7.7169 5.70937C7.8757 5.8494 7.97525 6.04463 7.99533 6.25539C8.01541 6.46616 7.95451 6.67667 7.825 6.84417L7.75583 6.9225L6.67917 8L7.75583 9.0775C7.89931 9.22099 7.98551 9.41191 7.99824 9.61443C8.01097 9.81695 7.94938 10.0172 7.825 10.1775L7.75583 10.2558C7.61234 10.3993 7.42142 10.4855 7.2189 10.4982C7.01638 10.511 6.81617 10.4494 6.65583 10.325Z"/>
   </svg>
   <span class="pst-collapse-sidebar-label">Collapse Sidebar</span>
   <span class="pst-expand-sidebar-label">Expand Sidebar</span>
 </button></div>
         <div class="sidebar-primary-item">

 <nav class="bd-docs-nav bd-links"
      aria-label="Section Navigation">
   <p class="bd-links__title" role="heading" aria-level="1">Section Navigation</p>
   <div class="bd-toc-item navbar-nav"></div>
 </nav></div>
     </div>


   <div class="sidebar-primary-items__end sidebar-primary__section">
       <div class="sidebar-primary-item">
 <div id="ethical-ad-placement"
       class="flat"
       data-ea-publisher="readthedocs"
       data-ea-type="readthedocs-sidebar"
       data-ea-manual="true">
 </div></div>
   </div>


       </div>

       <main id="main-content" class="bd-main" role="main">


           <div class="bd-content">
             <div class="bd-article-container">

               <div class="bd-header-article d-print-none">
 <div class="header-article-items header-article__inner">

     <div class="header-article-items__start">

         <div class="header-article-item">

 <nav aria-label="Breadcrumb" class="d-print-none">
   <ul class="bd-breadcrumbs">

     <li class="breadcrumb-item breadcrumb-home">
       <a href="../index.html" class="nav-link" aria-label="Home">
         <i class="fa-solid fa-home"></i>
       </a>
     </li>
     <li class="breadcrumb-item active" aria-current="page"><span class="ellipsis">Release</span></li>
   </ul>
 </nav>
 </div>

     </div>


 </div>
 </div>


 <div id="searchbox"></div>
                 <article class="bd-article">

   <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
   distributed with this work for additional information
   regarding copyright ownership.  The ASF licenses this file
   to you under the Apache License, Version 2.0 (the
   "License"); you may not use this file except in compliance
   with the License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing,
   software distributed under the License is distributed on an
   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   KIND, either express or implied.  See the License for the
   specific language governing permissions and limitations
   under the License.
 -->
 <section class="tex2jax_ignore mathjax_ignore" id="release">
 <h1>Release<a class="headerlink" href="#release" title="Link to this heading">#</a></h1>
 <section id="principles">
 <h2>Principles<a class="headerlink" href="#principles" title="Link to this heading">#</a></h2>
 <p>The Apache Arrow Release follows the guidelines defined at the <a class="reference external" href="https://www.apache.org/legal/release-policy.html">Apache
 Software Foundation Release
 Policy</a>.</p>
 </section>
 <section id="prepare">
 <h2>Prepare<a class="headerlink" href="#prepare" title="Link to this heading">#</a></h2>
 <p>Some steps of the release require being a committer or a PMC member.</p>
 <ul class="simple">
 <li><p>A GPG key in the Apache Web of Trust to sign artifacts. This will
 have to be cross signed by other Apache committers/PMC members. You
 must set your GPG key ID in <code class="docutils literal notranslate"><span class="pre">dev/release/.env</span></code> (see
 <code class="docutils literal notranslate"><span class="pre">dev/release/.env.example</span></code> for a template).</p></li>
 <li><p>The GPG key needs to be added to this <a class="reference external" href="https://dist.apache.org/repos/dist/dev/arrow/">Subversion repository for
 dev</a> and <a class="reference external" href="https://dist.apache.org/repos/dist/release/arrow/">Subversion
 repository for
 release</a>.</p></li>
 <li><p>An <a class="reference external" href="https://apache.jfrog.io">Artifactory</a> API key (log in with your
 ASF credentials, then generate it from your profile in the
 upper-right). You must set the Artifactory API key in
 <code class="docutils literal notranslate"><span class="pre">dev/release/.env</span></code> (see <code class="docutils literal notranslate"><span class="pre">dev/release/.env.example</span></code> for a
 template).</p></li>
 <li><p>A GitHub personal access token that has at lease <code class="docutils literal notranslate"><span class="pre">workflow</span></code>
 scope. You must set the GitHub personal access token in
 <code class="docutils literal notranslate"><span class="pre">dev/release/.env</span></code> (see <code class="docutils literal notranslate"><span class="pre">dev/release/.env.example</span></code> for a template).</p></li>
 <li><p>Clone <a class="reference external" href="https://github.com/apache/arrow">apache/arrow</a> and prepare
 <code class="docutils literal notranslate"><span class="pre">apache/arrow</span></code>’s <code class="docutils literal notranslate"><span class="pre">dev/release/.env</span></code> (see <code class="docutils literal notranslate"><span class="pre">dev/release/.env.example</span></code>
 for a template) like <code class="docutils literal notranslate"><span class="pre">apache/arrow-flight-sql-postgresql</span></code>’s
 <code class="docutils literal notranslate"><span class="pre">dev/release/.env</span></code>.</p></li>
 </ul>
 </section>
 <section id="create-a-rc">
 <h2>Create a RC<a class="headerlink" href="#create-a-rc" title="Link to this heading">#</a></h2>
 <p>Prepare a new RC when you create a first RC:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:rc:prepare<span class="w"> </span><span class="nv">ARROW_SOURCE</span><span class="o">=</span>/path/to/apache/arrow/repository/
 </pre></div>
 </div>
 <p>You need to specify your cloned <code class="docutils literal notranslate"><span class="pre">apache/arrow</span></code> repository.</p>
 <p>This creates a <code class="docutils literal notranslate"><span class="pre">prepare-${VERSION}</span></code> branch on local repository. You
 need to push it and open a new pull request for it.</p>
 <p>Tag for a new RC after the pull request is merged:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:rc:tag
 </pre></div>
 </div>
 <p>This creates a new tag for the new RC. You check it and push to
 <code class="docutils literal notranslate"><span class="pre">apache/arrow-flight-sql-postgresql</span></code>.</p>
 <p>Artifacts for the new RC are built automatically on GitHub Actions.</p>
 <p>Sign these artifacts:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:rc:sign
 </pre></div>
 </div>
 <p>Note that you don’t need to wait for finishing GitHub Actions jobs
 before you run the above command line. Because the above command line
 waits for finishing GitHub Actions jobs automatically.</p>
 <p>Upload Linux packages:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:rc:linux<span class="w"> </span><span class="nv">ARROW_SOURCE</span><span class="o">=</span>/path/to/apache/arrow/repository/
 </pre></div>
 </div>
 <p>You need to specify your cloned <code class="docutils literal notranslate"><span class="pre">apache/arrow</span></code> repository. You must
 prepare its <code class="docutils literal notranslate"><span class="pre">dev/release/.env</span></code> (not only
 <code class="docutils literal notranslate"><span class="pre">apache/arrow-flight-sql-postgresql</span></code>’s <code class="docutils literal notranslate"><span class="pre">dev/release/.env</span></code>.)</p>
 <p>Re-run RC verify CI jobs on GitHub Actions:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:rc:verify
 </pre></div>
 </div>
 <p>Start a vote thread for the new RC on <code class="docutils literal notranslate"><span class="pre">dev&#64;arrow.apache.org</span></code>. You can
 generate a vote e-mail template:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:vote
 </pre></div>
 </div>
 <p>Approval requires a net of 3 +1 votes from PMC members. A release
 cannot be vetoed.</p>
 </section>
 <section id="how-to-verify">
 <h2>How to verify<a class="headerlink" href="#how-to-verify" title="Link to this heading">#</a></h2>
 <section id="install-dependencies">
 <h3>Install dependencies<a class="headerlink" href="#install-dependencies" title="Link to this heading">#</a></h3>
 <p>At minimum, you will need:</p>
 <ul class="simple">
 <li><p>Apache Arrow C++ (Apache Arrow Flight SQL must be enabled)</p></li>
 <li><p>C++ compiler</p></li>
 <li><p>Git</p></li>
 <li><p>GnuPG</p></li>
 <li><p>Meson</p></li>
 <li><p>Ninja</p></li>
 <li><p>PostgreSQL 15 or later</p></li>
 <li><p>cURL</p></li>
 <li><p>jq</p></li>
 <li><p>shasum (built into macOS) or sha256sum/sha512sum (on Linux)</p></li>
 </ul>
 </section>
 <section id="verify">
 <h3>Verify<a class="headerlink" href="#verify" title="Link to this heading">#</a></h3>
 <p>Clone the project:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/apache/arrow-flight-sql-postgresql.git
 </pre></div>
 </div>
 <p>Run the verification script:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">cd</span><span class="w"> </span>arrow-flight-sql-postgresql
 <span class="c1"># Pass the version and the RC number.</span>
 <span class="c1"># This stops after build is succeeded. You need to verify manually after it.</span>
 <span class="c1"># See &quot;Hints&quot; the script shows what you do.</span>
 dev/release/verify-rc.sh<span class="w"> </span><span class="m">0</span>.1.0<span class="w"> </span><span class="m">1</span>
 </pre></div>
 </div>
 <p>These environment variables may be helpful:</p>
 <ul class="simple">
 <li><p><code class="docutils literal notranslate"><span class="pre">ARROW_TMPDIR=/path/to/directory</span></code> to specify the temporary directory
 used. Using a fixed directory can help avoid repeating the same
 setup and build steps if the script has to be run multiple times.</p></li>
 <li><p><code class="docutils literal notranslate"><span class="pre">TEST_SOURCE_MANUAL=0</span></code> to disable manual verification.</p></li>
 </ul>
 <p>Once finished and once the script passes, reply to the mailing list
 vote thread with a <code class="docutils literal notranslate"><span class="pre">+1</span></code> or a <code class="docutils literal notranslate"><span class="pre">-1</span></code>.</p>
 </section>
 </section>
 <section id="post-release-tasks">
 <h2>Post-release tasks<a class="headerlink" href="#post-release-tasks" title="Link to this heading">#</a></h2>
 <p>After the release vote, we must undertake the following tasks:</p>
 <p>Publish artifacts:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:rc:publish<span class="w"> </span><span class="nv">ARROW_SOURCE</span><span class="o">=</span>/path/to/apache/arrow/repository/
 </pre></div>
 </div>
 <p>This command line opens <a class="reference external" href="https://reporter.apache.org/addrelease.html?arrow">Apache
 reporter</a> by your
 Web browser. Don’t forget to register the new release by the form in
 the page.</p>
 <p>This command line creates the tag for the new release but doesn’t push
 it automatically by default. Don’t forget to push it.</p>
 <p>Publish release blog post. The following command line generates the
 blog post outline, then fill out outline and create a PR on
 <a class="reference external" href="https://github.com/apache/arrow-site"><code class="docutils literal notranslate"><span class="pre">apache/arrow-site</span></code></a>. You need
 to close your <code class="docutils literal notranslate"><span class="pre">apache/arrow-site</span></code> fork and specify the path of it as
 <code class="docutils literal notranslate"><span class="pre">ARROW_SITE</span></code>:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:announce:blog<span class="w"> </span><span class="nv">PREVIOUS_VERSION</span><span class="o">=</span>X.Y.Z<span class="w"> </span><span class="nv">ARROW_SITE</span><span class="o">=</span>/path/to/your/arrow-site/fork/repository
 </pre></div>
 </div>
 <p>Announce the new release on mailing lists. The following command line
 generates the announce e-mail outline, then fill out outline and send
 the announce e-mail to <code class="docutils literal notranslate"><span class="pre">announce&#64;apache.org</span></code>, <code class="docutils literal notranslate"><span class="pre">user&#64;arrow.apache.org</span></code>
 and <code class="docutils literal notranslate"><span class="pre">dev&#64;arrow.apache.org</span></code>. You must use your <code class="docutils literal notranslate"><span class="pre">&#64;apache.org</span></code> e-mail
 address to send an e-mail to <code class="docutils literal notranslate"><span class="pre">announce&#64;apache.org</span></code>:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:announce:mail
 </pre></div>
 </div>
 <p>Announce the new release on <code class="docutils literal notranslate"><span class="pre">pgsql-announce&#64;postgresql.org</span></code>.</p>
 <p>You need to create your PostgreSQL community account:
 <a class="reference external" href="https://www.postgresql.org/account/">https://www.postgresql.org/account/</a></p>
 <p>You need to join the Apache Arrow organization on PostgreSQL
 community. Please contact one of the organization managers such as
 <a class="reference external" href="https://github.com/kou">&#64;kou</a> to join the organization.</p>
 <p>The following command line generates the announce content. You can
 submit it to <a class="reference external" href="https://www.postgresql.org/account/edit/news/">https://www.postgresql.org/account/edit/news/</a> .</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:announce:postgresql<span class="w"> </span><span class="nv">ARROW_SITE</span><span class="o">=</span>/path/to/your/arrow-site/fork/repository
 </pre></div>
 </div>
 <p>Bump version:</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>rake<span class="w"> </span>release:version:bump<span class="w"> </span><span class="nv">NEW_VERSION</span><span class="o">=</span>X.Y.Z
 </pre></div>
 </div>
 </section>
 </section>


                 </article>


                 <footer class="prev-next-footer d-print-none">

 <div class="prev-next-area">
     <a class="left-prev"
        href="../client.html"
        title="previous page">
       <i class="fa-solid fa-angle-left"></i>
       <div class="prev-next-info">
         <p class="prev-next-subtitle">previous</p>
         <p class="prev-next-title">Client</p>
       </div>
     </a>
 </div>
                 </footer>

             </div>


                 <dialog id="pst-secondary-sidebar-modal"></dialog>
                 <div id="pst-secondary-sidebar" class="bd-sidebar-secondary bd-toc"><div class="sidebar-secondary-items sidebar-secondary__inner">


   <div class="sidebar-secondary-item">
 <div
     id="pst-page-navigation-heading-2"
     class="page-toc tocsection onthispage">
     <i class="fa-solid fa-list"></i> On this page
   </div>
   <nav id="pst-page-toc-nav" class="page-toc" aria-labelledby="pst-page-navigation-heading-2">
     <ul class="pst-show_toc_level nav section-nav flex-column">
 <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#principles">Principles</a></li>
 <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#prepare">Prepare</a></li>
 <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#create-a-rc">Create a RC</a></li>
 <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#how-to-verify">How to verify</a><ul class="nav section-nav flex-column">
 <li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#install-dependencies">Install dependencies</a></li>
 <li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#verify">Verify</a></li>
 </ul>
 </li>
 <li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#post-release-tasks">Post-release tasks</a></li>
 </ul>
   </nav></div>

   <div class="sidebar-secondary-item">


   <div class="tocsection editthispage">
     <a href="https://github.com/apache/arrow-flight-sql-postgresql/edit/main/doc/source/development/release.md">
       <i class="fa-solid fa-pencil"></i>


           Edit on GitHub


     </a>
   </div>
 </div>

   <div class="sidebar-secondary-item">

   <div class="tocsection sourcelink">
     <a href="../_sources/development/release.md.txt">
       <i class="fa-solid fa-file-lines"></i> Show Source
     </a>
   </div>
 </div>

 </div></div>


           </div>
           <footer class="bd-footer-content">

           </footer>

       </main>
     </div>
   </div>

   <!-- Scripts loaded after <body> so the DOM is not blocked -->
   <script defer src="../_static/scripts/bootstrap.js?digest=90905a2f556bf617f1a9"></script>
 <script defer src="../_static/scripts/pydata-sphinx-theme.js?digest=90905a2f556bf617f1a9"></script>

   <footer class="bd-footer">
 <div class="bd-footer__inner bd-page-width">

     <div class="footer-items__start">

         <div class="footer-item">

   <p class="copyright">

       © Copyright 2022-2023, Apache Arrow Developers.
       <br/>

   </p>
 </div>

         <div class="footer-item">

   <p class="sphinx-version">
     Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 9.1.0.
     <br/>
   </p>
 </div>

     </div>


     <div class="footer-items__end">

         <div class="footer-item">
 <p class="theme-version">
   <!-- # L10n: Setting the PST URL as an argument as this does not need to be localized -->
   Built with the <a href="https://pydata-sphinx-theme.readthedocs.io/en/stable/index.html">PyData Sphinx Theme</a> 0.20.0.
 </p></div>

     </div>

 </div>

   </footer>
   </body>
 </html>