{"title":"How to release Django","version":"6.0","locale":"id","docname":"internals/howto-release-django","url":"/id/6.0/internals/howto-release-django/","canonical":"https://djangodocs.dev/id/6.0/internals/howto-release-django/","summary":"Dokumen ini menjelaskan bagaimana menerbitkan Django. Harap, jaga petunjuk-petunjuk ini terbaru jika anda membuat perubahan! Titiknya disini adalah menjadi lebih…","html":"<h1>How to release Django<a class=\"heading-anchor\" href=\"#how-to-release-django\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Dokumen ini menjelaskan bagaimana menerbitkan Django.</p>\n<p><strong>Harap, jaga petunjuk-petunjuk ini terbaru jika anda membuat perubahan!</strong> Titiknya disini adalah menjadi lebih menggambarkan, bukan memberi petunjuk, jadi silahkan untuk mempersingkat atau jika tidak buat perubahan, tetapi <strong>perbaharui dokumen ini sesuai dengan itu!</strong></p>\n<section id=\"overview\">\n<h2>Ikhtisar<a class=\"heading-anchor\" href=\"#overview\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Terdapat tiga jenis terbitan yang anda mungkin butuh untuk dibuat:</p>\n<ul class=\"simple\">\n<li><p>Terbitan keamanan: mengungkap dan memperbaiki kerentanan. Ini umumnya melibatkan dua atau lebih terbitan beruntun -- misalnya 3.2.x, 4.0.x, dan, tergatung dari waktu, mungkin 4.1.x.</p></li>\n<li><p>Terbitan versi umum: salah satu terbitan akhir (misalnya 4.1) atau pembaharuan perbaikan kesalahan (misalnya 4.1.1).</p></li>\n<li><p>Pra-terbitan: misalnya 4.2 alpha, beta, atau rc.</p></li>\n</ul>\n<p>Versi pendek dari langkah-langkah bersangkutan adalah:</p>\n<ol class=\"arabic simple\">\n<li><p>Jika ini adalah terbitan keamanan, beritahu daftar penyebaran keamanan satu minggu sebelum terbitan sebenarnya.</p></li>\n<li><p>Proofread catatan terbitan, menacri kesalahan organisasi dan penulisan. Konsep sebuah penempatan blog dan pengumuman surel.</p></li>\n<li><p>Update version numbers and create the release artifacts.</p></li>\n<li><p>Create the new <code class=\"docutils literal notranslate\"><span class=\"pre\">Release</span></code> in the admin on <code class=\"docutils literal notranslate\"><span class=\"pre\">djangoproject.com</span></code>.</p>\n<ol class=\"arabic simple\">\n<li><p>Set the proper date but ensure the flag <code class=\"docutils literal notranslate\"><span class=\"pre\">is_active</span></code> is disabled.</p></li>\n<li><p>Upload the artifacts (tarball, wheel, and checksums).</p></li>\n</ol>\n</li>\n<li><p>Veridikasi tanda tangan paket, periksa jika mereka dapat dipasang, dan dan pastikan kegunaan minimal.</p></li>\n<li><p>Unggah versi terbaru ke PyPI.</p></li>\n<li><p>Enable the <code class=\"docutils literal notranslate\"><span class=\"pre\">is_active</span></code> flag for each release in the admin on\n<code class=\"docutils literal notranslate\"><span class=\"pre\">djangoproject.com</span></code>.</p></li>\n<li><p>Tempatkan masukan blog dan kirim pengumuman surel.</p></li>\n<li><p>Update version numbers post-release in stable branch(es).</p></li>\n<li><p>Add stub release notes for the next patch release in <code class=\"docutils literal notranslate\"><span class=\"pre\">main</span></code> and backport.</p></li>\n</ol>\n<p>Ada banyak rincian, jadi silahkan lanjutkan membaca.</p>\n<aside class=\"admonition-use-the-checklists-app admonition\" id=\"checklist-generator\">\n<p class=\"admonition-title\">Use the checklists app</p>\n<p>To generate a checklist compiling the tasks described below as relevant to\nthe specific release(s) you are issuing, use the checklists app in the\n<a class=\"reference external\" href=\"https://www.djangoproject.com/admin/checklists/\">project admin</a>. This\npopulates a lot of boilerplate you will need for announcements, CVE\npublication, and hashes for commit messages. By using this app for preparing\nsecurity issue metadata, your peer releasers can check your entries and\nconsult them again in the future. See <a class=\"reference external\" href=\"https://www.djangoproject.com/checklists/release/5.2.4/\">example checklist</a>.</p>\n</aside>\n</section>\n<section id=\"prerequisites\">\n<h2>Prasyarat<a class=\"heading-anchor\" href=\"#prerequisites\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>You'll need a few things before getting started. If this is your first release,\nyou'll need to coordinate with another releaser to get all these things lined\nup, and write to the Ops mailing list requesting the required access and\npermissions.</p>\n<ul>\n<li><p>Lingkungan Unix dengan alat alat ini terpasang (dalam urutan abjad):</p>\n<ul class=\"simple\">\n<li><p>bash</p></li>\n<li><p>git</p></li>\n<li><p>GPG</p></li>\n<li><p>membuat</p></li>\n<li><p>pria</p></li>\n<li><p>alat hashing (typically <code class=\"docutils literal notranslate\"><span class=\"pre\">md5sum</span></code>, <code class=\"docutils literal notranslate\"><span class=\"pre\">sha1sum</span></code>, dan <code class=\"docutils literal notranslate\"><span class=\"pre\">sha256sum</span></code> pada Linux, atau <code class=\"docutils literal notranslate\"><span class=\"pre\">md5</span></code> dan <code class=\"docutils literal notranslate\"><span class=\"pre\">shasum</span></code> pada macOS)</p></li>\n<li><p>python</p></li>\n</ul>\n</li>\n<li><p>A GPG key pair. Ensure that the private part of this key is securely stored.\nThe public part needs to be uploaded to your GitHub account, and also to the\nJenkins server running the &quot;confirm release&quot; job.</p>\n<aside class=\"admonition-more-than-one-gpg-key admonition\">\n<p class=\"admonition-title\">Lebih dari satu kunci GPG</p>\n<p>If the key you want to use is not your default signing key, you'll need to\nadd <code class=\"docutils literal notranslate\"><span class=\"pre\">-u</span> <span class=\"pre\">you&#64;example.com</span></code> to every GPG signing command shown below, where\n<code class=\"docutils literal notranslate\"><span class=\"pre\">you&#64;example.com</span></code> is the email address associated with the key you want\nto use.</p>\n</aside>\n</li>\n<li><p>A clean Python virtual environment (Python 3.9+) to build artifacts, with\nthese required Python packages installed:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>python<span class=\"w\"> </span>-m<span class=\"w\"> </span>pip<span class=\"w\"> </span>install<span class=\"w\"> </span>build<span class=\"w\"> </span>twine\n</code></pre></div>\n</li>\n<li><p>Access to <a class=\"reference external\" href=\"https://pypi.org/project/Django/\">Django's project on PyPI</a> to\nupload binaries, ideally with extra permissions to <a class=\"reference external\" href=\"https://pypi.org/help/#yanked\">yank a release</a> if necessary. Create a project-scoped token\nfollowing the <a class=\"reference external\" href=\"https://pypi.org/help/#apitoken\">official documentation</a>\nand set up your <code class=\"docutils literal notranslate\"><span class=\"pre\">$HOME/.pypirc</span></code> file like this:</p>\n<figure class=\"code-block code-block-captioned\" data-language=\"ini\"><figcaption class=\"code-block-caption\"><code class=\"docutils literal notranslate\"><span class=\"pre\">~/.pypirc</span></code></figcaption>\n<div class=\"code-block-toolbar\"><span class=\"code-block-language\">Ini</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Ini code\"><code><span class=\"k\">[distutils]</span>\n<span class=\"w\">  </span><span class=\"na\">index-servers</span><span class=\"w\"> </span><span class=\"o\">=</span>\n<span class=\"w\">    </span><span class=\"na\">pypi</span>\n<span class=\"w\">    </span><span class=\"na\">django</span>\n\n<span class=\"k\">[pypi]</span>\n<span class=\"w\">  </span><span class=\"na\">username</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"s\">__token__</span>\n<span class=\"w\">  </span><span class=\"na\">password</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"c1\"># User-scoped or project-scoped token, to set as the default.</span>\n\n<span class=\"k\">[django]</span>\n<span class=\"w\">  </span><span class=\"na\">repository</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"s\">https://upload.pypi.org/legacy/</span>\n<span class=\"w\">  </span><span class=\"na\">username</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"s\">__token__</span>\n<span class=\"w\">  </span><span class=\"na\">password</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"c1\"># A project token.</span>\n</code></pre></figure>\n</li>\n<li><p>Access to <a class=\"reference external\" href=\"https://app.transifex.com/django/django/\">Django's project on Transifex</a>, with a Manager role. Generate\nan API Token in the <a class=\"reference external\" href=\"https://app.transifex.com/user/settings/api/\">user setting section</a> and set up your\n<code class=\"docutils literal notranslate\"><span class=\"pre\">$HOME/.transifexrc</span></code> file like this:</p>\n<figure class=\"code-block code-block-captioned\" data-language=\"ini\"><figcaption class=\"code-block-caption\"><code class=\"docutils literal notranslate\"><span class=\"pre\">~/.transifexrc</span></code></figcaption>\n<div class=\"code-block-toolbar\"><span class=\"code-block-language\">Ini</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Ini code\"><code><span class=\"k\">[https://www.transifex.com]</span>\n<span class=\"w\">  </span><span class=\"na\">rest_hostname</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"s\">https://rest.api.transifex.com</span>\n<span class=\"w\">  </span><span class=\"na\">token</span><span class=\"w\"> </span><span class=\"o\">=</span><span class=\"w\"> </span><span class=\"c1\"># API token</span>\n</code></pre></figure>\n</li>\n<li><p>Access to the Django admin on <code class=\"docutils literal notranslate\"><span class=\"pre\">djangoproject.com</span></code> as a &quot;Site maintainer&quot;.</p></li>\n<li><p>Access to create a post in the <a class=\"reference external\" href=\"https://forum.djangoproject.com/c/announcements/7\">Django Forum - Announcements category</a> and to send emails to\nthe <a class=\"reference external\" href=\"https://groups.google.com/g/django-announce/\">django-announce</a>\nmailing list.</p></li>\n<li><p>Access to the <code class=\"docutils literal notranslate\"><span class=\"pre\">django-security</span></code> repo in GitHub. Among other things, this\nprovides access to the pre-notification distribution list (needed for\nsecurity release preparation tasks).</p></li>\n<li><p>Access to the Django project on <a class=\"reference external\" href=\"https://readthedocs.org/projects/django/\">Read the Docs</a>.</p></li>\n</ul>\n</section>\n<section id=\"pre-release-tasks\">\n<h2>Tugas-tugas pra terbitan<a class=\"heading-anchor\" href=\"#pre-release-tasks\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>A few items need to be taken care of before even beginning the release process.\nThis stuff starts about a week before the release; most of it can be done\nany time leading up to the actual release.</p>\n<section id=\"or-more-days-before-a-security-release\">\n<h3>10 (atau lebih) hari sebelum terbitan keamanan<a class=\"heading-anchor\" href=\"#or-more-days-before-a-security-release\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<ol class=\"arabic\">\n<li><p>Reserve one <a class=\"reference external\" href=\"https://www.cve.org/About/Overview/\">CVE ID</a> per security\nissue as follows. (Or, if you lack CNA credentials, email\n<code class=\"docutils literal notranslate\"><span class=\"pre\">cna&#64;djangoproject.com</span></code> with a request.)</p>\n<ul>\n<li><p>Enable virtual environment with <a class=\"extlink-pypi reference external\" href=\"https://pypi.org/project/cvelib/\">cvelib</a> installed.</p></li>\n<li><p>Export user information:</p>\n<blockquote>\n<div><div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span><span class=\"nb\">export</span><span class=\"w\"> </span><span class=\"nv\">CVE_USER</span><span class=\"o\">=</span>&lt;user-email&gt;@djangoproject.com<span class=\"w\"> </span><span class=\"nv\">CVE_ORG</span><span class=\"o\">=</span>DSF\n</code></pre></div>\n</div></blockquote>\n</li>\n<li><p>Reserve:</p>\n<blockquote>\n<div><div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>cve<span class=\"w\"> </span>--interactive<span class=\"w\"> </span>reserve<span class=\"w\"> </span>&lt;quantity&gt;\n</code></pre></div>\n</div></blockquote>\n</li>\n</ul>\n</li>\n<li><p>Generate the relevant (private) patch(es) using <code class=\"docutils literal notranslate\"><span class=\"pre\">git</span> <span class=\"pre\">format-patch</span></code>, one\nfor the <code class=\"docutils literal notranslate\"><span class=\"pre\">main</span></code> branch and one for each stable branch being patched.</p></li>\n</ol>\n</section>\n<section id=\"a-week-before-a-security-release\">\n<h3>Seminggu sebelum terbitan keamanan<a class=\"heading-anchor\" href=\"#a-week-before-a-security-release\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<ol class=\"arabic\">\n<li><p>Send out pre-notification exactly <strong>one week</strong> before the security release.\nThe template for that email and a list of the recipients are in the private\n<code class=\"docutils literal notranslate\"><span class=\"pre\">django-security</span></code> GitHub wiki. BCC the pre-notification recipients, and be\nsure to include the relevant CVE IDs. Attach all the relevant patches\n(targeting <code class=\"docutils literal notranslate\"><span class=\"pre\">main</span></code> and the stable branches), and sign the email text with\nthe key you'll use for the release, with a command like:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>gpg<span class=\"w\"> </span>--clearsign<span class=\"w\"> </span>--digest-algo<span class=\"w\"> </span>SHA256<span class=\"w\"> </span>prenotification-email.txt\n</code></pre></div>\n</li>\n<li><p><a class=\"reference internal\" href=\"/id/6.0/internals/security/#security-disclosure\"><span class=\"std std-ref\">Notify django-announce</span></a> dari terbitan keamanan yang akan datang dengan pesan umum seperti:</p>\n<div class=\"code-block\" data-language=\"text\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Text</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Text code\"><code>Notice of upcoming Django security releases (3.2.24, 4.2.10 and 5.0.2)\n\nDjango versions 5.0.2, 4.2.10, and 3.2.24 will be released on Tuesday,\nFebruary 6th, 2024 around 1500 UTC. They will fix one security defect\nwith severity &quot;moderate&quot;.\n\nFor details of severity levels, see:\nhttps://docs.djangoproject.com/en/dev/internals/security/#how-django-discloses-security-issues\n</code></pre></div>\n</li>\n<li><p>Prepare issue metadata:\n* Severity\n* Short description\n* Reporter\n* Remediator\n* Reported at\n* Confirmed at (usually date CVE reserved)\n* CWE Problem Type\n* CAPEC Impact Type\n* CVSS (4.0) Score &amp; Vector</p></li>\n</ol>\n</section>\n<section id=\"a-few-days-before-any-release\">\n<h3>Beberapa hari sebelum terbitan<a class=\"heading-anchor\" href=\"#a-few-days-before-any-release\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<ol class=\"arabic\">\n<li><p>As the release approaches, watch Trac to make sure no release blockers are\nleft for the upcoming release. Under exceptional circumstances, such as to\nmeet a pre-determined security release date, a release could still go ahead\nwith an open release blocker. The releaser is trusted with the decision to\nrelease with an open release blocker or to postpone the release date of a\nnon-security release if required.</p></li>\n<li><p>Check with the other mergers to make sure they don't have any uncommitted\nchanges for the release.</p></li>\n<li><p>Proofread the release notes, including looking at the online version to\n<a class=\"reference internal\" href=\"/id/6.0/internals/contributing/writing-documentation/#documentation-link-check\"><span class=\"std std-ref\">catch any broken links</span></a> or reST errors, and\nmake sure the release notes contain the correct date.</p></li>\n<li><p>Periksa kembali itu catatan terbitan menyebutkan linimasa pengusangan untuk setiap API dicatat sebagai diusangkan, dan mereka menyebut bahwa tiap perubahan di Python versi dukungan.</p></li>\n<li><p>Periksa kembali itu catatan terbitan index mempunyai sebuah tautan ke catatan untuk terbitan baru; ini akan ada di <code class=\"docutils literal notranslate\"><span class=\"pre\">docs/releases/index.txt</span></code>.</p></li>\n<li><p>If this is a <a class=\"reference internal\" href=\"/id/6.0/internals/release-process/#term-Feature-release\"><span class=\"xref std std-term\">feature release</span></a>, ensure translations from Transifex\nhave been integrated.</p>\n<p>In addition to having a configured Transifex account, ensure that the <a class=\"reference external\" href=\"https://developers.transifex.com/docs/cli\">tx\nCLI</a> is available in your\n<code class=\"docutils literal notranslate\"><span class=\"pre\">PATH</span></code>. You can then fetch all translations since a given date by running:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>python<span class=\"w\"> </span>scripts/manage_translations.py<span class=\"w\"> </span>fetch<span class=\"w\"> </span>-v<span class=\"w\"> </span><span class=\"m\">1</span><span class=\"w\"> </span>--since<span class=\"o\">=</span>&lt;some<span class=\"w\"> </span>date&gt;\n</code></pre></div>\n<p>To determine a good value for <code class=\"docutils literal notranslate\"><span class=\"pre\">--since</span></code>, check the date of the most recent\ncommit with wording similar to <code class=\"docutils literal notranslate\"><span class=\"pre\">Updated</span> <span class=\"pre\">translations</span> <span class=\"pre\">from</span> <span class=\"pre\">Transifex</span></code> and\nuse a date a few days prior.</p>\n<p>This command takes some time to run. When done, carefully inspect the output\nfor potential errors and/or warnings. If there are some, you will need to\ndebug and resolve them on a case by case basis.</p>\n<p>The recently fetched translations need some manual adjusting. First of all,\nthe <code class=\"docutils literal notranslate\"><span class=\"pre\">PO-Revision-Date</span></code> values must be manually bumped to be later than\n<code class=\"docutils literal notranslate\"><span class=\"pre\">POT-Creation-Date</span></code>. You can use a command similar to this to bulk update\nall the <code class=\"docutils literal notranslate\"><span class=\"pre\">.po</span></code> files (compare the diff against the relevant stable branch):</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>git<span class=\"w\"> </span>diff<span class=\"w\"> </span>--name-only<span class=\"w\"> </span>stable/5.0.x<span class=\"w\"> </span><span class=\"p\">|</span><span class=\"w\"> </span>grep<span class=\"w\"> </span><span class=\"s2\">&quot;\\.po&quot;</span><span class=\"w\">  </span><span class=\"p\">|</span><span class=\"w\"> </span>xargs<span class=\"w\"> </span>sed<span class=\"w\"> </span>-ri<span class=\"w\"> </span><span class=\"s2\">&quot;s/PO-Revision-Date: [0-9\\-]+ /PO-Revision-Date: </span><span class=\"k\">$(</span>date<span class=\"w\"> </span>-I<span class=\"k\">)</span><span class=\"s2\"> /g&quot;</span>\n</code></pre></div>\n<p>Lastly, commit the changed/added files (both <code class=\"docutils literal notranslate\"><span class=\"pre\">.po</span></code> and <code class=\"docutils literal notranslate\"><span class=\"pre\">.mo</span></code>) and create\na new PR targeting the stable branch of the corresponding release (example\n<a class=\"reference external\" href=\"https://github.com/django/django/pull/16715\">PR updating translations for 4.2</a>).</p>\n<p>Once merged, forward port the changes into <code class=\"docutils literal notranslate\"><span class=\"pre\">main</span></code> (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/cb27e5b9c0703fb0edd70b2138e3e53a78c9551d\">example commit</a>).</p>\n</li>\n<li><p><a class=\"reference internal\" href=\"/id/6.0/internals/contributing/writing-documentation/#django-admin-manpage\"><span class=\"std std-ref\">Update the django-admin manual page</span></a>:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span><span class=\"nb\">cd</span><span class=\"w\"> </span>docs\n$<span class=\"w\"> </span>make<span class=\"w\"> </span>man\n$<span class=\"w\"> </span>man<span class=\"w\"> </span>_build/man/django-admin.1<span class=\"w\">  </span><span class=\"c1\"># do a quick sanity check</span>\n$<span class=\"w\"> </span>cp<span class=\"w\"> </span>_build/man/django-admin.1<span class=\"w\"> </span>man/django-admin.1\n</code></pre></div>\n<p>dan kemudian perbaiki perubahan halaman panduan.</p>\n</li>\n<li><p>If this is the &quot;dot zero&quot; release of a new series, create a new branch from\nthe current stable branch in the <a class=\"reference external\" href=\"https://github.com/django/django-docs-translations\">django-docs-translations</a> repository. For\nexample, when releasing Django 4.2:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>git<span class=\"w\"> </span>checkout<span class=\"w\"> </span>-b<span class=\"w\"> </span>stable/4.2.x<span class=\"w\"> </span>origin/stable/4.1.x\n$<span class=\"w\"> </span>git<span class=\"w\"> </span>push<span class=\"w\"> </span>origin<span class=\"w\"> </span>stable/4.2.x:stable/4.2.x\n</code></pre></div>\n</li>\n<li><p>Tulis penempatan blog pengumuman untuk terbitan. Anda dapat memasukkannya kedalam admin kapan pun dan menandainya sebagai tidak aktif. Ini adalah beberapa contoh: <a class=\"reference external\" href=\"https://www.djangoproject.com/weblog/2013/feb/19/security/\">example security release announcement</a>, <a class=\"reference external\" href=\"https://www.djangoproject.com/weblog/2012/mar/23/14/\">example regular release announcement</a>, <a class=\"reference external\" href=\"https://www.djangoproject.com/weblog/2012/nov/27/15-beta-1/\">example pre-release announcement</a>.</p></li>\n</ol>\n<section id=\"a-few-days-before-a-feature-freeze\">\n<h4>A few days before a feature freeze<a class=\"heading-anchor\" href=\"#a-few-days-before-a-feature-freeze\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h4>\n<p>In preparation for the alpha release, the directory\n<code class=\"docutils literal notranslate\"><span class=\"pre\">/home/www/www/media/releases/A.B</span></code> must be created on the djangoproject\nserver.</p>\n<p>Before the feature freeze, a branch targeting <code class=\"docutils literal notranslate\"><span class=\"pre\">main</span></code> must be created to\nprepare for the next feature release. It should be reviewed and approved a few\ndays before the freeze, allowing it to be merged after the stable branch is\ncut. The following items should be addressed in this branch:</p>\n<ol class=\"arabic simple\">\n<li><p>Perbaharui <code class=\"docutils literal notranslate\"><span class=\"pre\">VERSION</span></code> tuple di <code class=\"docutils literal notranslate\"><span class=\"pre\">django/__init__.py</span></code>, menaik ke terbitan yang diharapkan selanjutnya (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/96700c7b378c592f0b1732302c22af2fd2c87fc6\">example commit</a>).</p></li>\n<li><p>Create a stub release note for the next feature release. Use the stub from\nthe previous feature release or copy the contents from the current version\nand delete most of the contents leaving only the headings\n(<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/9b5ad4056ccf9ff7ea548f72d28eb66c1b4f84cc\">example commit</a>).</p></li>\n<li><p>Remove <code class=\"docutils literal notranslate\"><span class=\"pre\">..</span> <span class=\"pre\">versionadded::</span></code> and <code class=\"docutils literal notranslate\"><span class=\"pre\">..</span> <span class=\"pre\">versionchanged::</span></code> annotations in the\ndocumentation from two releases ago, as well as any remaining older\nannotations. For example, in Django 5.1, notes for 4.2 will be removed\n(<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/9edb7833b89e811eefd94974fb987f4605b0c0d7\">example commit</a>).</p></li>\n<li><p>Remove features that have reached the end of their deprecation cycle,\nincluding their docs and the <code class=\"docutils literal notranslate\"><span class=\"pre\">..</span> <span class=\"pre\">deprecated::</span></code> annotation. Each removal\nshould be done in a separate commit for clarity. In the commit message, add\na <code class=\"docutils literal notranslate\"><span class=\"pre\">Refs</span> <span class=\"pre\">#XXXXX</span> <span class=\"pre\">--</span></code> prefix linking to the original ticket where the\ndeprecation began if possible. Make sure this gets noted in the removed\nfeatures section in the release notes (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/f2d9c76aa7096ef3eed675b9eb824858f9dd81e5\">example commit</a>).</p></li>\n<li><p>Increase the default PBKDF2 iterations in\n<code class=\"docutils literal notranslate\"><span class=\"pre\">django.contrib.auth.hashers.PBKDF2PasswordHasher</span></code> by about 20%\n(pick a round number). Run the tests, and update the 3 failing\nhasher tests with the new values. Make sure this gets noted in the\nrelease notes (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/7288866da4dddf3705148c703421858ec19cdb78\">example commit</a>).</p></li>\n</ol>\n<p>Concrete examples for past feature release bootstrap branches: <a class=\"reference external\" href=\"https://github.com/django/django/pull/18127\">5.2 bootstrap</a>, <a class=\"reference external\" href=\"https://github.com/django/django/pull/17246\">5.1 bootstrap</a>, <a class=\"reference external\" href=\"https://github.com/django/django/pull/16432\">5.0 bootstrap</a>.</p>\n</section>\n</section>\n</section>\n<section id=\"feature-freeze-tasks\">\n<h2>Feature freeze tasks<a class=\"heading-anchor\" href=\"#feature-freeze-tasks\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<ol class=\"arabic\">\n<li><p>Remove empty sections from the release notes (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/9e6e58bad237a80ddd5e3ab8b834cecdaad8455e\">example commit</a>).</p></li>\n<li><p>Build the release notes locally and read them. Make any necessary change\nto improve flow or fix grammar (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/435bdab93889dae01e71c79598edab10627cc1f9\">example commit</a>).</p></li>\n<li><p>Create a new stable branch from <code class=\"docutils literal notranslate\"><span class=\"pre\">main</span></code>. Be sure to fetch and update\n<code class=\"docutils literal notranslate\"><span class=\"pre\">upstream</span></code> to latest. For example, when feature freezing Django 5.2:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>git<span class=\"w\"> </span>fetch<span class=\"w\"> </span>upstream\n$<span class=\"w\"> </span>git<span class=\"w\"> </span>checkout<span class=\"w\"> </span>-b<span class=\"w\"> </span>stable/5.2.x<span class=\"w\"> </span>upstream/main\n$<span class=\"w\"> </span>git<span class=\"w\"> </span>push<span class=\"w\"> </span>upstream<span class=\"w\"> </span>-u<span class=\"w\"> </span>stable/5.2.x:stable/5.2.x\n</code></pre></div>\n<p>At the same time, update the <code class=\"docutils literal notranslate\"><span class=\"pre\">django_next_version</span></code> variable in\n<code class=\"docutils literal notranslate\"><span class=\"pre\">docs/conf.py</span></code> on the stable release branch to point to the new\ndevelopment version. For example, when creating <code class=\"docutils literal notranslate\"><span class=\"pre\">stable/5.2.x</span></code>, set\n<code class=\"docutils literal notranslate\"><span class=\"pre\">django_next_version</span></code> to <code class=\"docutils literal notranslate\"><span class=\"pre\">'6.0'</span></code> on the new stable branch\n(<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/1eb62e5b622ef7fd6e0123d8bbf6662d893d5d08\">example commit</a>).</p>\n</li>\n<li><p>Create <code class=\"docutils literal notranslate\"><span class=\"pre\">Release</span></code> entries for the next version in the <a class=\"reference external\" href=\"https://www.djangoproject.com/admin/releases/release/add/\">admin</a> on\n<code class=\"docutils literal notranslate\"><span class=\"pre\">djangoproject.com</span></code>. Add one for each milestone (alpha, beta, rc, and\nfinal), leaving <em>is active</em> unset to mark them as unreleased. Set target\ndates per the agreed schedule, and set the LTS flag if applicable. The\n<code class=\"docutils literal notranslate\"><span class=\"pre\">X.Y</span></code> roadmap page will be available at <code class=\"docutils literal notranslate\"><span class=\"pre\">/download/X.Y/roadmap/</span></code>.</p>\n<p>For example, when creating <code class=\"docutils literal notranslate\"><span class=\"pre\">stable/5.2.x</span></code>, add <code class=\"docutils literal notranslate\"><span class=\"pre\">Release</span></code> entries for\n<code class=\"docutils literal notranslate\"><span class=\"pre\">6.0a1</span></code>, <code class=\"docutils literal notranslate\"><span class=\"pre\">6.0b1</span></code>, <code class=\"docutils literal notranslate\"><span class=\"pre\">6.0rc1</span></code>, and <code class=\"docutils literal notranslate\"><span class=\"pre\">6.0</span></code>. The <code class=\"docutils literal notranslate\"><span class=\"pre\">6.0</span></code> roadmap can be\nthen reviewed at <a class=\"reference external\" href=\"https://www.djangoproject.com/download/6.0/roadmap/\">https://www.djangoproject.com/download/6.0/roadmap/</a>.</p>\n</li>\n<li><p>Go to the <a class=\"reference external\" href=\"https://www.djangoproject.com/admin/docs/documentrelease/add/\">Add document release page in the admin</a>, create a new\n<code class=\"docutils literal notranslate\"><span class=\"pre\">DocumentRelease</span></code> object for the English language for the newly created\n<code class=\"docutils literal notranslate\"><span class=\"pre\">Release</span></code> object. Do not mark this as default.</p>\n</li>\n<li><p>Add the new branch to <a class=\"reference external\" href=\"https://readthedocs.org/projects/django/\">Read the Docs</a>. Since the automatically\ngenerated version names (&quot;stable-A.B.x&quot;) differ from the version names used\nin Read the Docs (&quot;A.B.x&quot;), update the Read the Docs config for the version\nto point to the slug <code class=\"docutils literal notranslate\"><span class=\"pre\">A.B.x</span></code> and set it as active. <a class=\"reference external\" href=\"https://github.com/readthedocs/readthedocs.org/issues/12483\">See more details</a>.</p></li>\n<li><p><a class=\"reference external\" href=\"https://github.com/pypa/trove-classifiers/pulls?q=is%3Apr+django+trove+classifier\">Create a PR on PyPI proposing the new Trove classifier</a>.\nFor example <code class=\"docutils literal notranslate\"><span class=\"pre\">Framework</span> <span class=\"pre\">::</span> <span class=\"pre\">Django</span> <span class=\"pre\">::</span> <span class=\"pre\">5.2</span></code>.</p></li>\n<li><p>Update the current branch under active development and add pre-release\nbranch in the <a class=\"reference external\" href=\"https://code.djangoproject.com/#Djangoreleaseprocess\">Django release process</a> on Trac.</p></li>\n<li><p>Update the <code class=\"docutils literal notranslate\"><span class=\"pre\">docs/fixtures/doc_releases.json</span></code> JSON fixture for\ndjangoproject.com, so people without access to the production DB can still\nrun an up-to-date copy of the docs site\n(<a class=\"reference external\" href=\"https://github.com/django/djangoproject.com/pull/1446\">example PR</a>).\nThis will be merged after the final release.</p></li>\n</ol>\n</section>\n<section id=\"actually-rolling-the-release\">\n<h2>Sebenarnya menggulir terbitan<a class=\"heading-anchor\" href=\"#actually-rolling-the-release\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>OK, this is the fun part, where we actually push out a release! If you're\nissuing <strong>multiple releases</strong>, repeat these steps for each release.</p>\n<ol class=\"arabic\">\n<li><p>Check <a class=\"reference external\" href=\"https://djangoci.com\">Jenkins</a> is green for the version(s) you're putting out. You\nprobably shouldn't issue a release until it's green, and you should make\nsure that the latest green run includes the changes that you are releasing.</p>\n</li>\n<li><p>Cleanup the release notes for this release. Make these changes in <code class=\"docutils literal notranslate\"><span class=\"pre\">main</span></code>\nand backport to all branches where the release notes for a particular\nversion are located.</p>\n<ol class=\"arabic simple\">\n<li><p>For a feature release, remove the <code class=\"docutils literal notranslate\"><span class=\"pre\">UNDER</span> <span class=\"pre\">DEVELOPMENT</span></code> header at the top\nof the release notes, remove the <code class=\"docutils literal notranslate\"><span class=\"pre\">Expected</span></code> prefix and update the\nrelease date, if necessary (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/1994a2643881a9e3f9fa8d3e0794c1a9933a1831\">example commit</a>).</p></li>\n<li><p>For a patch release, remove the <code class=\"docutils literal notranslate\"><span class=\"pre\">Expected</span></code> prefix and update the\nrelease date for all releases, if necessary (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/34a503162fe222033a1cd3249bccad014fcd1d20\">example commit</a>).</p></li>\n</ol>\n</li>\n<li><p>A release always begins from a release branch, so you should make sure\nyou're on an up-to-date stable branch. Also, you should have available a\nclean and dedicated virtual environment per version being released. For\nexample:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>git<span class=\"w\"> </span>checkout<span class=\"w\"> </span>stable/4.1.x\n$<span class=\"w\"> </span>git<span class=\"w\"> </span>pull\n</code></pre></div>\n</li>\n<li><p>If this is a security release, merge the appropriate patches from\n<code class=\"docutils literal notranslate\"><span class=\"pre\">django-security</span></code>. Rebase these patches as necessary to make each one a\nplain commit on the release branch rather than a merge commit. To ensure\nthis, merge them with the <code class=\"docutils literal notranslate\"><span class=\"pre\">--ff-only</span></code> flag; for example:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>git<span class=\"w\"> </span>checkout<span class=\"w\"> </span>stable/4.1.x\n$<span class=\"w\"> </span>git<span class=\"w\"> </span>merge<span class=\"w\"> </span>--ff-only<span class=\"w\"> </span>security/4.1.x\n</code></pre></div>\n<p>(This assumes <code class=\"docutils literal notranslate\"><span class=\"pre\">security/4.1.x</span></code> is a branch in the <code class=\"docutils literal notranslate\"><span class=\"pre\">django-security</span></code> repo\ncontaining the necessary security patches for the next release in the 4.1\nseries.)</p>\n<p>If git refuses to merge with <code class=\"docutils literal notranslate\"><span class=\"pre\">--ff-only</span></code>, switch to the security-patch\nbranch and rebase it on the branch you are about to merge it into (<code class=\"docutils literal notranslate\"><span class=\"pre\">git</span>\n<span class=\"pre\">checkout</span> <span class=\"pre\">security/4.1.x;</span> <span class=\"pre\">git</span> <span class=\"pre\">rebase</span> <span class=\"pre\">stable/4.1.x</span></code>) and then switch back and\ndo the merge. Make sure the commit message for each security fix explains\nthat the commit is a security fix and that an announcement will follow\n(<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/bf39978a53f117ca02e9a0c78b76664a41a54745\">example security commit</a>).</p>\n</li>\n<li><p>Angka versi pembaharuan di <code class=\"docutils literal notranslate\"><span class=\"pre\">django/__init__.py</span></code> untuk terbitan. Silahkan lihat <a class=\"reference internal\" href=\"#notes-on-setting-the-version-tuple\">notes on setting the VERSION tuple</a> dibawah untuk rincian pada <code class=\"docutils literal notranslate\"><span class=\"pre\">VERSION</span></code> (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/2719a7f8c161233f45d34b624a9df9392c86cc1b\">example commit</a>).</p>\n<ol class=\"arabic simple\">\n<li><p>If this is a pre-release package also update the &quot;Development Status&quot;\ntrove classifier in <code class=\"docutils literal notranslate\"><span class=\"pre\">pyproject.toml</span></code> to reflect this. An <code class=\"docutils literal notranslate\"><span class=\"pre\">rc</span></code>\npre-release should not change the trove classifier (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/759921c8e9ad151932fc913ab429fef0a6112ef8\">example\ncommit for alpha release</a>,\n<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/25fec8940b24107e21314ab6616e18ce8dec1c1c\">example commit for beta release</a>).</p></li>\n<li><p>Sebaliknya, pastikan penggolong disetel ke <code class=\"docutils literal notranslate\"><span class=\"pre\">Development</span> <span class=\"pre\">Status</span> <span class=\"pre\">::</span> <span class=\"pre\">5</span> <span class=\"pre\">-</span> <span class=\"pre\">Production/Stable</span></code>.</p></li>\n</ol>\n</li>\n</ol>\n<section id=\"building-the-artifacts\">\n<h3>Building the artifacts<a class=\"heading-anchor\" href=\"#building-the-artifacts\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<aside class=\"admonition-optionally-use-helper-scripts admonition\">\n<p class=\"admonition-title\">Optionally use helper scripts</p>\n<p>You can streamline some of the steps below using helper scripts from the\n<code class=\"docutils literal notranslate\"><span class=\"pre\">scripts</span></code> folder:</p>\n<ul class=\"simple\">\n<li><p>Release script example run:</p></li>\n</ul>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span><span class=\"nv\">PGP_KEY_ID</span><span class=\"o\">=</span>&lt;key-id&gt;<span class=\"w\"> </span><span class=\"nv\">PGP_KEY_URL</span><span class=\"o\">=</span>&lt;key-url&gt;<span class=\"w\"> </span><span class=\"nv\">DEST_FOLDER</span><span class=\"o\">=</span>~/releases<span class=\"w\"> </span>scripts/do_django_release.py\n</code></pre></div>\n<ul class=\"simple\">\n<li><p>Verify the release (after artifacts were uploaded):</p></li>\n</ul>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span><span class=\"nv\">VERSION</span><span class=\"o\">=</span><span class=\"m\">5</span>.2.1<span class=\"w\"> </span>scripts/verify_release.sh\n</code></pre></div>\n</aside>\n<ol class=\"arabic\">\n<li><p>Etiket terbitan menggunakan <code class=\"docutils literal notranslate\"><span class=\"pre\">git</span> <span class=\"pre\">tag</span></code>. Sebagai contoh:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>git<span class=\"w\"> </span>tag<span class=\"w\"> </span>--sign<span class=\"w\"> </span>--message<span class=\"o\">=</span><span class=\"s2\">&quot;Tag 4.1.1&quot;</span><span class=\"w\"> </span><span class=\"m\">4</span>.1.1\n</code></pre></div>\n<p>Anda dapat memeriksa pekerjaan berjalan anda <code class=\"docutils literal notranslate\"><span class=\"pre\">git</span> <span class=\"pre\">tag</span> <span class=\"pre\">--verify</span> <span class=\"pre\">&lt;tag&gt;</span></code>.</p>\n</li>\n<li><p>Pastikan anda mempunyai pohon sepenuhnya bersih dengan menjalankan <code class=\"docutils literal notranslate\"><span class=\"pre\">git</span> <span class=\"pre\">clean</span> <span class=\"pre\">-dfx</span></code>.</p></li>\n<li><p>Run <code class=\"docutils literal notranslate\"><span class=\"pre\">python</span> <span class=\"pre\">-m</span> <span class=\"pre\">build</span></code> to generate the release packages. This will create\nthe release artifacts (tarball and wheel) in a <code class=\"docutils literal notranslate\"><span class=\"pre\">dist/</span></code> directory. For\nDjango 5.0 or older, you need to run <code class=\"docutils literal notranslate\"><span class=\"pre\">make</span> <span class=\"pre\">-f</span> <span class=\"pre\">extras/Makefile</span></code> instead.</p></li>\n<li><p>Bangkitkan hash dari paket terbitan:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span><span class=\"nb\">cd</span><span class=\"w\"> </span>dist\n$<span class=\"w\"> </span>md5sum<span class=\"w\"> </span>*\n$<span class=\"w\"> </span>sha1sum<span class=\"w\"> </span>*\n$<span class=\"w\"> </span>sha256sum<span class=\"w\"> </span>*\n</code></pre></div>\n</li>\n<li><p>Create a &quot;checksums&quot; file, <code class=\"docutils literal notranslate\"><span class=\"pre\">Django-&lt;&lt;VERSION&gt;&gt;.checksum.txt</span></code> containing\nthe hashes and release information. Start with this template and insert the\ncorrect version, date, GPG key ID (from\n<code class=\"docutils literal notranslate\"><span class=\"pre\">gpg</span> <span class=\"pre\">--list-keys</span> <span class=\"pre\">--keyid-format</span> <span class=\"pre\">LONG</span></code>), release manager's GitHub username,\nrelease URL, and checksums:</p>\n<div class=\"code-block\" data-language=\"text\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Text</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Text code\"><code>This file contains MD5, SHA1, and SHA256 checksums for the source-code\ntarball and wheel files of Django &lt;&lt;VERSION&gt;&gt;, released &lt;&lt;DATE&gt;&gt;.\n\nTo use this file, you will need a working install of PGP or other\ncompatible public-key encryption software. You will also need to have\nthe Django release manager&#39;s public key in your keyring. This key has\nthe ID ``XXXXXXXXXXXXXXXX`` and can be imported from GitHub, for example,\nif using the open-source GNU Privacy Guard implementation of PGP:\n\n    curl https://github.com/&lt;&lt;RELEASE MANAGER GITHUB USERNAME&gt;&gt;.gpg | gpg --import -\n\nOnce the key is imported, verify this file:\n\n    gpg --verify &lt;&lt;THIS FILENAME&gt;&gt;\n\nOnce you have verified this file, you can use normal MD5, SHA1, or SHA256\nchecksumming applications to generate the checksums of the Django\npackage and compare them to the checksums listed below.\n\nRelease packages\n================\n\nhttps://www.djangoproject.com/download/&lt;&lt;VERSION&gt;&gt;/tarball/\nhttps://www.djangoproject.com/download/&lt;&lt;VERSION&gt;&gt;/wheel/\n\nMD5 checksums\n=============\n\n&lt;&lt;MD5SUM&gt;&gt;  &lt;&lt;RELEASE TAR.GZ FILENAME&gt;&gt;\n&lt;&lt;MD5SUM&gt;&gt;  &lt;&lt;RELEASE WHL FILENAME&gt;&gt;\n\nSHA1 checksums\n==============\n\n&lt;&lt;SHA1SUM&gt;&gt;  &lt;&lt;RELEASE TAR.GZ FILENAME&gt;&gt;\n&lt;&lt;SHA1SUM&gt;&gt;  &lt;&lt;RELEASE WHL FILENAME&gt;&gt;\n\nSHA256 checksums\n================\n\n&lt;&lt;SHA256SUM&gt;&gt;  &lt;&lt;RELEASE TAR.GZ FILENAME&gt;&gt;\n&lt;&lt;SHA256SUM&gt;&gt;  &lt;&lt;RELEASE WHL FILENAME&gt;&gt;\n</code></pre></div>\n</li>\n<li><p>Tandatangi berkas checksum (<code class=\"docutils literal notranslate\"><span class=\"pre\">gpg</span> <span class=\"pre\">--clearsign</span> <span class=\"pre\">--digest-algo</span> <span class=\"pre\">SHA256</span> <span class=\"pre\">Django-&lt;version&gt;.checksum.txt</span></code>). Ini membangkitkan dokumen ditandatangi, <code class=\"docutils literal notranslate\"><span class=\"pre\">Django-&lt;version&gt;.checksum.txt.asc</span></code> yang anda dapat kemudian memeriksa menggunakan <code class=\"docutils literal notranslate\"><span class=\"pre\">gpg</span> <span class=\"pre\">--verify</span> <span class=\"pre\">Django-&lt;version&gt;.checksum.txt.asc</span></code>.</p></li>\n</ol>\n</section>\n</section>\n<section id=\"making-the-release-s-available-to-the-public\">\n<h2>Membuat terbitan tesedia ke umum<a class=\"heading-anchor\" href=\"#making-the-release-s-available-to-the-public\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Sekarang anda siap benar-benar menaruh terbitan diluar sana. Untuk melakukan ini:</p>\n<ol class=\"arabic\">\n<li><p>Create a new <code class=\"docutils literal notranslate\"><span class=\"pre\">Release</span></code> entry in the <a class=\"reference external\" href=\"https://www.djangoproject.com/admin/releases/release/add/\">djangoproject.com's admin</a>. If this is a\nsecurity release, this should be done 15 minutes before the announced\nrelease time, no sooner:</p>\n<dl class=\"simple\">\n<dt>Versi</dt><dd><p>Must match the version number as defined in the tarball\n(<code class=\"docutils literal notranslate\"><span class=\"pre\">django-&lt;version&gt;.tar.gz</span></code>). For example: &quot;5.2&quot;, &quot;4.1.1&quot;, or &quot;4.2rc1&quot;.</p>\n</dd>\n<dt>Aktif</dt><dd><p>Set to False until the release is fully published (last step).</p>\n</dd>\n<dt>LTS</dt><dd><p>Enable if the release is part of an <abbr title=\"Long Term Support\">LTS</abbr>\nbranch.</p>\n</dd>\n<dt>Tanggal</dt><dd><p>Set the release date to today. This release will not be published until\n<code class=\"docutils literal notranslate\"><span class=\"pre\">is_active</span></code> is enabled.</p>\n</dd>\n<dt>Artifacts</dt><dd><p>Upload the tarball (<code class=\"docutils literal notranslate\"><span class=\"pre\">django-&lt;version&gt;.tar.gz</span></code>), wheel\n(<code class=\"docutils literal notranslate\"><span class=\"pre\">django-&lt;version&gt;-py3-none-any.whl</span></code>), and checksum\n(<code class=\"docutils literal notranslate\"><span class=\"pre\">django-&lt;version&gt;.checksum.txt.asc</span></code>) files created earlier.</p>\n</dd>\n</dl>\n</li>\n<li><p>Test that the release packages install correctly using <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code>. Here's one\nsimple method (this just tests that the binaries are available, that they\ninstall correctly, and that migrations and the development server start, but\nit'll catch silly mistakes):\n<a class=\"reference external\" href=\"https://code.djangoproject.com/wiki/ReleaseTestNewVersion\">https://code.djangoproject.com/wiki/ReleaseTestNewVersion</a>.</p></li>\n<li><p>Jalankan bangun <a class=\"reference external\" href=\"https://djangoci.com/job/confirm-release/\">confirm-release</a> pada Jenkins untuk verifikasi berkas checksum (misalnya gunakan <code class=\"docutils literal notranslate\"><span class=\"pre\">4.2rc1</span></code> untuk <a class=\"reference external\" href=\"https://media.djangoproject.com/pgp/Django-4.2rc1.checksum.txt\">https://media.djangoproject.com/pgp/Django-4.2rc1.checksum.txt</a>).</p>\n</li>\n<li><p>Upload the release packages to PyPI:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>twine<span class=\"w\"> </span>upload<span class=\"w\"> </span>--repository<span class=\"w\"> </span>django<span class=\"w\"> </span>dist/*\n</code></pre></div>\n</li>\n<li><p>Update the newly created <code class=\"docutils literal notranslate\"><span class=\"pre\">Release</span></code> in the admin in <code class=\"docutils literal notranslate\"><span class=\"pre\">djangoproject.com</span></code>\nand enable the <code class=\"docutils literal notranslate\"><span class=\"pre\">is_active</span></code> flag.</p></li>\n<li><p>Dorong pekerjaan anda dan tambah etiket baru:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>git<span class=\"w\"> </span>push\n$<span class=\"w\"> </span>git<span class=\"w\"> </span>push<span class=\"w\"> </span>--tags\n</code></pre></div>\n</li>\n<li><p>Buat blog menempatkan pengumuman terbitan langsung.</p></li>\n<li><p>Untuk terbitan versi baru (misalnya 4.1, 4.2), perbaharui versi stabil awal dari dokumen dengan membalikkan bendera <code class=\"docutils literal notranslate\"><span class=\"pre\">is_default</span></code> menjadi <code class=\"docutils literal notranslate\"><span class=\"pre\">True</span></code> pada obyek <code class=\"docutils literal notranslate\"><span class=\"pre\">DocumentRelease</span></code> yang sesuai di basisdata <code class=\"docutils literal notranslate\"><span class=\"pre\">docs.djangoproject.com</span></code> (ini akan otomatis menggantinya menjadi <code class=\"docutils literal notranslate\"><span class=\"pre\">False</span></code> untuk semua lainnya); anda dapat melakukan ini menggunakan admin situs.</p>\n<p>Create new <code class=\"docutils literal notranslate\"><span class=\"pre\">DocumentRelease</span></code> objects for each language that has an entry\nfor the previous release. Update djangoproject.com's <a class=\"reference external\" href=\"https://github.com/django/djangoproject.com/blob/main/djangoproject/static/robots.docs.txt\">robots.docs.txt</a>\nfile by copying the result generated from running the command\n<code class=\"docutils literal notranslate\"><span class=\"pre\">manage_translations.py</span> <span class=\"pre\">robots_txt</span></code> in the current stable branch from the\n<a class=\"reference external\" href=\"https://github.com/django/django-docs-translations\">django-docs-translations repository</a>. For example, when releasing Django\n4.2:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>git<span class=\"w\"> </span>checkout<span class=\"w\"> </span>stable/4.2.x\n$<span class=\"w\"> </span>git<span class=\"w\"> </span>pull\n$<span class=\"w\"> </span>python<span class=\"w\"> </span>manage_translations.py<span class=\"w\"> </span>robots_txt\n</code></pre></div>\n</li>\n<li><p>Post the release announcement to the <a class=\"reference internal\" href=\"/id/6.0/internals/mailing-lists/#django-announce-mailing-list\"><span class=\"std std-ref\">django-announce</span></a> mailing list and the\nDjango Forum. This should include a link to the announcement blog post.</p></li>\n<li><p>If this is a security release, publish the CVE metadata. (The\n<a class=\"reference internal\" href=\"#checklist-generator\"><span class=\"std std-ref\">checklist app</span></a> generates JSON for this.):</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>cve<span class=\"w\"> </span>publish<span class=\"w\"> </span>&lt;cve-number&gt;<span class=\"w\"> </span>--cve-json-file<span class=\"w\"> </span>&lt;path-to-file&gt;\n</code></pre></div>\n</li>\n<li><p>If this is a security release, send a separate email to\n<code class=\"docutils literal notranslate\"><span class=\"pre\">oss-security&#64;lists.openwall.com</span></code>. Provide &quot;Django&quot; plus the CVE IDs in\nthe subject line. The message body should include the vulnerability details,\nfor example, the announcement blog post text. Include a link to the\nannouncement blog post.</p></li>\n</ol>\n</section>\n<section id=\"post-release\">\n<h2>Pasca-terbitan<a class=\"heading-anchor\" href=\"#post-release\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Anda hampir selesai! Semua yang tersisa untuk dilakukan sekarang adalah:</p>\n<ol class=\"arabic\">\n<li><p>If this is not a pre-release, update the <code class=\"docutils literal notranslate\"><span class=\"pre\">VERSION</span></code> tuple in\n<code class=\"docutils literal notranslate\"><span class=\"pre\">django/__init__.py</span></code> again, incrementing to whatever the next expected\nrelease will be. For example, after releasing 4.1.1, update <code class=\"docutils literal notranslate\"><span class=\"pre\">VERSION</span></code> to\n<code class=\"docutils literal notranslate\"><span class=\"pre\">VERSION</span> <span class=\"pre\">=</span> <span class=\"pre\">(4,</span> <span class=\"pre\">1,</span> <span class=\"pre\">2,</span> <span class=\"pre\">'alpha',</span> <span class=\"pre\">0)</span></code> (<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/a4d19953d46247ee1992b3427fe652e941524272\">example commit</a>).</p></li>\n<li><p>If this was an alpha release:</p>\n<ol class=\"arabic\">\n<li><p>Add the feature release version in <a class=\"reference external\" href=\"https://code.djangoproject.com/admin/ticket/versions\">Trac's versions list</a>.</p></li>\n<li><p>Create a new security branch from the freshly cut stable branch. Be sure\nto fetch and update <code class=\"docutils literal notranslate\"><span class=\"pre\">upstream</span></code> to latest. For example, after the 5.2\nalpha release:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>git<span class=\"w\"> </span>fetch<span class=\"w\"> </span>upstream\n$<span class=\"w\"> </span>git<span class=\"w\"> </span>checkout<span class=\"w\"> </span>-b<span class=\"w\"> </span>security/5.2.x<span class=\"w\"> </span>upstream/stable/5.2.x\n$<span class=\"w\"> </span>git<span class=\"w\"> </span>push<span class=\"w\"> </span>origin<span class=\"w\"> </span>-u<span class=\"w\"> </span>security/5.2.x:security/5.2.x\n</code></pre></div>\n</li>\n</ol>\n</li>\n<li><p>Jika ini adalah terbitan akhir:</p>\n<ol class=\"arabic simple\">\n<li><p>Update the <code class=\"docutils literal notranslate\"><span class=\"pre\">default_version</span></code> setting in the code.djangoproject.com's\n<code class=\"docutils literal notranslate\"><span class=\"pre\">trac.ini</span></code> file (<a class=\"reference external\" href=\"https://github.com/django/code.djangoproject.com/pull/268\">example PR</a>).</p></li>\n<li><p>Update the current stable branch and remove the pre-release branch in the\n<a class=\"reference external\" href=\"https://code.djangoproject.com/#Djangoreleaseprocess\">Django release process</a> on Trac.</p></li>\n<li><p>Perbaharui halaman unduh (<a class=\"reference external\" href=\"https://github.com/django/djangoproject.com/pull/1444\">example PR</a>).</p></li>\n<li><p>Process the older versions that will reach End-Of-Mainstream and/or\nEnd-Of-Life support when this final release is published:</p>\n<ol class=\"arabic simple\">\n<li><p>Ensure that the EOL versions are mentioned in the blog post. See\n<a class=\"reference external\" href=\"https://www.djangoproject.com/weblog/2025/apr/02/django-52-released/\">example announcement</a>.</p></li>\n<li><p>Create a tag for the EOL stable branch and delete the stable branch.\nInspect and use the <code class=\"docutils literal notranslate\"><span class=\"pre\">scripts/archive_eol_stable_branches.py</span></code> helper.</p></li>\n</ol>\n</li>\n</ol>\n</li>\n<li><p>Jika ini adalah terbitan keamanan, perbaharui <a class=\"reference internal\" href=\"/id/6.0/releases/security/\"><span class=\"doc\">Arsip dari masalah keamanan</span></a> dengan rincian dari masalah-masalah yang dialamatkan.</p></li>\n<li><p>If this was a pre-release, the translation catalogs need to be updated:</p>\n<ol class=\"arabic\">\n<li><p>Make a new branch from the recently released stable branch:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>git<span class=\"w\"> </span>checkout<span class=\"w\"> </span>stable/A.B.x\n$<span class=\"w\"> </span>git<span class=\"w\"> </span>checkout<span class=\"w\"> </span>-b<span class=\"w\"> </span>update-translations-catalog-A.B.x\n</code></pre></div>\n</li>\n<li><p>Ensure that the release's dedicated virtual environment is enabled and\nrun the following:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span><span class=\"nb\">cd</span><span class=\"w\"> </span>django\n$<span class=\"w\"> </span>django-admin<span class=\"w\"> </span>makemessages<span class=\"w\"> </span>-l<span class=\"w\"> </span>en<span class=\"w\"> </span>--domain<span class=\"o\">=</span>djangojs<span class=\"w\"> </span>--domain<span class=\"o\">=</span>django\nprocessing<span class=\"w\"> </span>locale<span class=\"w\"> </span>en\n</code></pre></div>\n</li>\n<li><p>Make a pull request against the corresponding stable branch and merge\nonce approved.</p></li>\n<li><p>Forward port the updated source translations to the <code class=\"docutils literal notranslate\"><span class=\"pre\">main</span></code> branch\n(<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/aed303aff57ac990894b6354af001b0e8ea55f71\">example commit</a>).</p></li>\n</ol>\n</li>\n<li><p>If this was an <code class=\"docutils literal notranslate\"><span class=\"pre\">alpha</span></code> pre-release, coordinate with the maintainer of\n<a class=\"extlink-pypi reference external\" href=\"https://pypi.org/project/asgiref/\">asgiref</a> to determine when to raise the minimum version before the\nfinal release. For the backport, add an upper bound on the next major\nversion (example commits:\n<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/df35cf578f99522dd1ba864d513be95d47bab7a5\">main</a>,\n<a class=\"extlink-commit reference external\" href=\"https://github.com/django/django/commit/e5d2664908164d51d2daa46e375da8b6a93def03\">backport</a>).</p></li>\n<li><p>If this was an <code class=\"docutils literal notranslate\"><span class=\"pre\">rc</span></code> pre-release, call for translations for the upcoming\nrelease in the <a class=\"reference external\" href=\"https://forum.djangoproject.com/c/internals/i18n/14\">Django Forum - Internationalization category</a>.</p></li>\n</ol>\n</section>\n<section id=\"notes-on-setting-the-version-tuple\">\n<h2>Catatan pada pengaturan tuple VERSION<a class=\"heading-anchor\" href=\"#notes-on-setting-the-version-tuple\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Pelaporan versi Django dikendalikan oleh tuple <code class=\"docutils literal notranslate\"><span class=\"pre\">VERSION</span></code> di <code class=\"docutils literal notranslate\"><span class=\"pre\">django/__init__.py</span></code>. Ini adalah lima-unsur tuple, yang unsurnya adalah:</p>\n<ol class=\"arabic simple\">\n<li><p>Versi utama.</p></li>\n<li><p>Versi kecil.</p></li>\n<li><p>Versi mikro.</p></li>\n<li><p>Keadaan -- dapat menjadi satu dari &quot;alpha&quot;, &quot;beta&quot;, &quot;rc&quot; atau &quot;final&quot;.</p></li>\n<li><p>Rangkaian angka, untuk paket alpha/beta/RC yang berjalan dalam urutan (mengizinkan, sebagai contoh, &quot;beta 1&quot;, &quot;beta 2&quot;, etc.).</p></li>\n</ol>\n<p>Untuk terbitan akhir, keadaan selalu &quot;final&quot; dan rangkaian angka selalu 0. Rangkaian angka dari 0 dengan keadaan &quot;alpha&quot; akan dilaporkan sebagai &quot;pre-alpha&quot;.</p>\n<p>Beberapa contoh:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">(4,</span> <span class=\"pre\">1,</span> <span class=\"pre\">1,</span> <span class=\"pre\">&quot;final&quot;,</span> <span class=\"pre\">0)</span></code> → &quot;4.1.1&quot;</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">(4,</span> <span class=\"pre\">2,</span> <span class=\"pre\">0,</span> <span class=\"pre\">&quot;alpha&quot;,</span> <span class=\"pre\">0)</span></code> → &quot;4.2 pre-alpha&quot;</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">(4,</span> <span class=\"pre\">2,</span> <span class=\"pre\">0,</span> <span class=\"pre\">&quot;beta&quot;,</span> <span class=\"pre\">1)</span></code> → &quot;4.2 beta 1&quot;</p></li>\n</ul>\n</section>","rootId":"how-to-release-django","toc":[{"title":"Ikhtisar","anchor":"overview","children":[]},{"title":"Prasyarat","anchor":"prerequisites","children":[]},{"title":"Tugas-tugas pra terbitan","anchor":"pre-release-tasks","children":[{"title":"10 (atau lebih) hari sebelum terbitan keamanan","anchor":"or-more-days-before-a-security-release","children":[]},{"title":"Seminggu sebelum terbitan keamanan","anchor":"a-week-before-a-security-release","children":[]},{"title":"Beberapa hari sebelum terbitan","anchor":"a-few-days-before-any-release","children":[{"title":"A few days before a feature freeze","anchor":"a-few-days-before-a-feature-freeze","children":[]}]}]},{"title":"Feature freeze tasks","anchor":"feature-freeze-tasks","children":[]},{"title":"Sebenarnya menggulir terbitan","anchor":"actually-rolling-the-release","children":[{"title":"Building the artifacts","anchor":"building-the-artifacts","children":[]}]},{"title":"Membuat terbitan tesedia ke umum","anchor":"making-the-release-s-available-to-the-public","children":[]},{"title":"Pasca-terbitan","anchor":"post-release","children":[]},{"title":"Catatan pada pengaturan tuple VERSION","anchor":"notes-on-setting-the-version-tuple","children":[]}],"breadcrumbs":[{"docname":"internals/index","title":"Dalam Django","url":"/id/6.0/internals/"}],"prev":{"docname":"internals/git","title":"Gudang sumber kode Django","url":"/id/6.0/internals/git/"},"next":null,"formats":{"html":"/id/6.0/internals/howto-release-django/","markdown":"/id/6.0/internals/howto-release-django.md","json":"/id/6.0/internals/howto-release-django.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/internals/howto-release-django.txt","official":"https://docs.djangoproject.com/id/6.0/internals/howto-release-django/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}