Så här släpper du Django¶

Detta dokument förklarar hur du släpper Django.

Poängen här är att vara beskrivande, inte föreskrivande, så känn dig fri att effektivisera eller på annat sätt göra ändringar, men **uppdatera detta dokument i enlighet med detta!

Översikt¶

Det finns tre typer av releaser som du kan behöva göra:

Säkerhetsreleaser: avslöja och åtgärda en sårbarhet. Detta innebär i allmänhet två eller tre samtidiga releaser - t.ex. 3.2.x, 4.0.x och, beroende på tidpunkt, kanske en 4.1.x.
Regelbundna versionsreleaser: antingen en slutlig version (t.ex. 4.1) eller en buggfixuppdatering (t.ex. 4.1.1).
Förhandsversioner: t.ex. 4.2 alpha, beta eller rc.

Den korta versionen av de inblandade stegen är:

Om det rör sig om en säkerhetsrelease ska du meddela säkerhetsdistributionslistan en vecka före den faktiska releasen.
Korrekturläsa versionsinformation, leta efter organisations- och skrivfel. Skriva ett blogginlägg och ett e-postmeddelande.
Uppdatera versionsnummer och skapa artefakter för releasen.
Skapa den nya Release i administratören på djangoproject.com.
1. Ange rätt datum men se till att flaggan is_active är inaktiverad.
2. Ladda upp artefakterna (tarball, wheel och checksummor).
Verifiera paketens signaturer, kontrollera om de kan installeras och säkerställa minimal funktionalitet.
Ladda upp den nya versionen/versionerna till PyPI.
Aktivera flaggan is_active för varje utgåva i administratören på djangoproject.com.
Publicera blogginlägget och skicka ut e-postmeddelandena.
Uppdatera versionsnummer efter release i stabila grenar.
Lägg till stub versionsinformation för nästa patch release i main och backport.

Det finns många detaljer, så läs gärna vidare.

Använd checklist-appen

För att skapa en checklista som sammanställer de uppgifter nedan som är relevanta för de specifika utgåvor du gör, använder du checklist-appen i projektadministrationen. Den fyller i mycket av den standardtext du behöver för tillkännagivanden, CVE-publicering och hashar i commitmeddelanden. När du använder appen för att förbereda metadata för säkerhetsärenden kan andra releaseansvariga kontrollera dina poster och använda dem igen i framtiden. Se en exempelchecklista.

Förutsättningar¶

Du behöver några saker innan du sätter igång. Om det här är din första release måste du samordna med en annan releaser för att få allt detta klart, och skriva till Ops e-postlista och begära nödvändig åtkomst och behörigheter.

En Unix-miljö med dessa verktyg installerade (i alfabetisk ordning):
- bash (version 4.0+)
- git
- GPG
- göra
- man
- hashingverktyg (vanligtvis md5sum, sha1sum och sha256sum på Linux, eller md5 och shasum på macOS)
- python
Ett GPG-nyckelpar. Lagra den privata delen säkert och skydda den med en lösenfras. Den offentliga delen måste laddas upp till ditt GitHub-konto.

Mer än en GPG-nyckel

Om den nyckel du vill använda inte är din standardsigneringsnyckel måste du lägga till -u you@example.com till varje GPG-signeringskommando som visas nedan, där you@example.com är den e-postadress som är kopplad till den nyckel du vill använda.
En ren virtuell Python-miljö (Python 3.10+, pip 26.1+) för att bygga artefakter.
Åtkomst till Djangos projekt på PyPI för att ladda upp binärfiler, helst med ytterligare behörighet att vid behov dra tillbaka en utgåva. Se till att ditt PyPI-konto endast använder WebAuthn-baserade autentiseringsfaktorer, inte TOTP (engångskoder). Skapa en API-token enligt den officiella dokumentationen och konfigurera sedan filen $HOME/.pypirc så här:
~/.pypirc¶
```
[distutils]
  index-servers =
    pypi
    django

[pypi]
  username = __token__
  password = # User-scoped or project-scoped token, to set as the default.

[django]
  repository = https://upload.pypi.org/legacy/
  username = __token__
  password = # A project token.
```
Åtkomst till Djangos projekt på Transifex, med rollen Manager. Skapa en API-token i avsnittet för användarinställningar och konfigurera sedan filen $HOME/.transifexrc så här:
~/.transifexrc¶
```
[https://www.transifex.com]
  rest_hostname = https://rest.api.transifex.com
  token = # API token
```
Tillgång till Django-administratören på djangoproject.com som ”Site maintainer”.
Behörighet att skapa ett inlägg i Django Forum – kategorin Announcements och att skicka e-post till sändlistan django-announce.
Tillgång till django-security repo i GitHub. Detta ger bland annat tillgång till distributionslistan för föranmälningar (behövs för förberedelser inför säkerhetsreleaser).
Åtkomst till Django-projektet på Read the Docs.

Uppgifter före lansering¶

Några saker måste tas om hand innan man ens påbörjar releaseprocessen. Det här börjar ungefär en vecka före lanseringen; det mesta kan göras när som helst fram till den faktiska lanseringen.

10 (eller fler) dagar före en säkerhetsrelease¶

Reservera ett CVE-id per säkerhetsproblem enligt följande. (Eller, om du saknar CNA-behörighet, skicka en begäran via e-post till cna@djangoproject.com.)
- Aktivera en virtuell miljö där cvelib är installerat.
- Exportera användarinformation:
```
$ export CVE_USER=<user-email>@djangoproject.com CVE_ORG=DSF
```
- Reservera:
```
$ cve --interactive reserve <quantity>
```
Generera relevanta (privata) patchar med hjälp av git format-patch, en för main-grenen och en för varje stabil gren som patchar.

En vecka före en säkerhetsrelease¶

Skicka ut förhandsmeddelande exakt en vecka före säkerhetsreleasen. Mallen för e-postmeddelandet och mottagarlistan finns i den privata GitHub-wikin django-security. Använd BCC för mottagarna av förhandsmeddelandet och se till att inkludera relevanta CVE-id:n. Bifoga alla relevanta patchar (för main och de stabila grenarna), och signera e-posttexten med den nyckel som du kommer att använda för releasen, med ett kommando som:
```
$ gpg --clearsign --digest-algo SHA256 prenotification-email.txt
```

Notify django-announce of the upcoming security release with a general message such as:

Notice of upcoming Django security releases (3.2.24, 4.2.10 and 5.0.2)

Django versions 5.0.2, 4.2.10, and 3.2.24 will be released on Tuesday,
February 6th, 2024 around 1500 UTC. They will fix one security defect
with severity "moderate".

For details of severity levels, see:
https://docs.djangoproject.com/en/dev/internals/security/#how-django-discloses-security-issues

Förbered ärendemetadata: * Allvarlighetsgrad * Kort beskrivning * Rapportör * Åtgärdare * Rapporterad vid * Bekräftad vid (vanligen datumet då CVE:n reserverades) * CWE-problemtyp * CAPEC-påverkansform * CVSS-poäng och -vektor (4.0)

Några dagar före eventuell lansering¶

När releasen närmar sig ska du titta på Trac för att se till att inga releaseblockerare finns kvar för den kommande releasen. Under exceptionella omständigheter, t.ex. för att uppfylla ett förutbestämt säkerhetsdatum, kan en release fortfarande ske med en öppen releaseblockerare. Det är upp till releasegivaren att besluta om en release ska ske med en öppen releaseblockerare eller om releasedatumet för en icke-säkerhetsrelease ska skjutas upp om så krävs.
Kontrollera med de andra sammanslagningarna för att se till att de inte har några ändringar som inte har bekräftats för utgåvan.
Korrekturläsa versionsinformation, inklusive att titta på online-versionen för att fånga upp eventuella brutna länkar eller reST-fel, och se till att versionsinformation innehåller rätt datum.
Dubbelkolla att versionsnoterna nämner tidsfrister för föråldring för alla API: er som anges som föråldrade, och att de nämner eventuella ändringar i Python-versionens stöd.
Dubbelkolla att versionsinformation-indexet har en länk till noterna för den nya releasen; detta kommer att finnas i docs/releases/index.txt.
Om detta är en funktionsrelease ska du säkerställa att översättningarna från Transifex har integrerats.

Utöver att ha ett konfigurerat Transifex-konto ska du se till att tx CLI är tillgängligt i din PATH. Du kan sedan hämta alla översättningar sedan ett visst datum genom att köra:
```
$ python scripts/manage_translations.py fetch -v 1 --since=<some date>
```
För att avgöra ett bra värde för --since kan du kontrollera datumet för den senaste committen med formulering som liknar Updated translations from Transifex och använda ett datum några dagar tidigare.

Det här kommandot tar lite tid att köra. När det är klart ska du noggrant granska utdata efter eventuella fel och/eller varningar. Om det finns några måste du felsöka och lösa dem från fall till fall.

De nyligen hämtade översättningarna behöver justeras manuellt. Först och främst måste värdena för PO-Revision-Date manuellt flyttas så att de är senare än POT-Creation-Date. Du kan använda ett kommando som liknar detta för att massuppdatera alla .po-filer (jämför diffen mot den relevanta stabila grenen):
```
$ git diff --name-only stable/5.0.x | grep "\.po"  | xargs sed -ri "s/PO-Revision-Date: [0-9\-]+ /PO-Revision-Date: $(date -I) /g"
```
Till sist: committa de ändrade eller tillagda filerna (både .po och .mo) och skapa en ny PR mot den stabila grenen för motsvarande utgåva (exempelvis PR som uppdaterar översättningar för 4.2).

När ändringarna har slagits samman, vidarebefordra dem till main (exempelcommit).

Uppdatera sidan django-admin manual:

$ cd docs
$ make man
$ man _build/man/django-admin.1  # do a quick sanity check
$ cp _build/man/django-admin.1 man/django-admin.1

och sedan publicera den ändrade man-sidan.

Om detta är ”nollutgåvan” för en ny serie, skapa en ny gren från den aktuella stabila grenen i arkivet django-docs-translations. Exempelvis vid utgivning av Django 4.2:
```
$ git checkout -b stable/4.2.x origin/stable/4.1.x
$ git push origin stable/4.2.x:stable/4.2.x
```
Skriv blogginlägget för tillkännagivandet av releasen. Du kan när som helst lägga in det i admin och markera det som inaktivt. Här är några exempel: ”Exempel på meddelande om säkerhetsrelease”, ”Exempel på meddelande om vanlig release”, ”Exempel på meddelande om pre-release”.

Några dagar innan en funktion fryses¶

Som förberedelse för alfaversionen måste katalogen /home/www/www/media/releases/A.B skapas på djangoprojektets server.

Innan funktionen fryses måste en gren med inriktning på main skapas för att förbereda för nästa funktionsrelease. Den bör granskas och godkännas några dagar före frysningen, så att den kan slås samman efter att den stabila grenen har klippts. Följande punkter bör tas upp i den här grenen:

Uppdatera tupeln VERSION i django/__init__.py och öka till nästa förväntade utgåva (exempel commit).
Skapa en stub release note för nästa feature release. Använd stubben från den tidigare versionen eller kopiera innehållet från den aktuella versionen och ta bort det mesta av innehållet så att endast rubrikerna kvarstår (exempel commit).
Ta bort ... versionadded:: och ... versionchanged:: anteckningar i dokumentationen från två utgåvor sedan, liksom alla återstående äldre anteckningar. Till exempel, i Django 5.1 kommer anteckningar för 4.2 att tas bort (example commit).
Ta bort funktioner som har nått slutet av sin utfasningscykel, inklusive deras dokument och annoteringen ...deprecated::. Varje borttagning bör göras i en separat commit för tydlighetens skull. I commit-meddelandet, lägg till ett Refs #XXXXX -- prefix som länkar till det ursprungliga ärendet där avskrivningen började om möjligt. Se till att detta noteras i avsnittet om borttagna funktioner i versionsinformation (example commit).
Gå vidare med avvecklingsvarningarna (exempelcommit).
Öka standard PBKDF2 iterationer i django.contrib.auth.hashers.PBKDF2PasswordHasher med cirka 20% (välj ett runt tal). Kör testerna och uppdatera de 3 misslyckade hasher-testerna med de nya värdena. Se till att detta noteras i versionsinformation (exempel commit).

Konkreta exempel på bootstrap-grenar för tidigare funktionsreleaser: bootstrap för 5.2, bootstrap för 5.1, bootstrap för 5.0.

Frysa funktioner för uppgifter¶

Ta bort tomma avsnitt från versionsinformation (exempel commit).
Bygg versionsinformation lokalt och läs dem. Gör eventuella nödvändiga ändringar för att förbättra flödet eller fixa grammatiken (exempel commit).
Skapa en ny stabil gren från main. Se till att hämta och uppdatera upstream till den senaste versionen. Till exempel när Django 5.2 funktionsfryses:
```
$ git fetch upstream
$ git checkout -b stable/5.2.x upstream/main
$ git push upstream -u stable/5.2.x:stable/5.2.x
```
Samtidigt uppdaterar du variabeln django_next_version i docs/conf.py på den stabila utgivningsgrenen så att den pekar på den nya utvecklingsversionen. Till exempel, när du skapar stable/5.2.x, sätt django_next_version till '6.0' på den nya stabila grenen (example commit).
Skapa poster av typen Release för nästa version i administrationen på djangoproject.com. Lägg till en för varje milstolpe (alpha, beta, rc och final) och låt is active vara avmarkerad för att markera dem som ej utgivna. Ange måldatum enligt överenskommen planering och sätt LTS-flaggan om den är tillämplig. Vägsidan för X.Y kommer att finnas på /download/X.Y/roadmap/.

När du till exempel skapar stable/5.2.x lägger du till poster av typen Release för 6.0a1, 6.0b1, 6.0rc1 och 6.0. Färdplanen för 6.0 kan sedan granskas på https://www.djangoproject.com/download/6.0/roadmap/.
Gå till sidan `Lägg till dokumentutgåva i admin`__, skapa ett nytt DocumentRelease-objekt för det engelska språket för det nyskapade Release-objektet. Markera inte detta som standard.
Lägg till den nya grenen på Read the Docs. Eftersom de automatiskt genererade versionsnamnen (”stable-A.B.x”) skiljer sig från versionsnamnen som används i Read the Docs (”A.B.x”), uppdaterar du Read the Docs-konfigurationen för versionen så att den pekar på sluggen A.B.x och anger den som aktiv. Se fler detaljer.
Skapa en PR på PyPI som föreslår den nya Trove-klassificeringen. Exempelvis Framework :: Django :: 5.2.
Uppdatera den aktuella grenen under aktiv utveckling och lägg till förutgivningsgrenen i Djangos releaseprocess på Trac.
Uppdatera docs/fixtures/doc_releases.json JSON-fixturen för djangoproject.com, så att personer utan tillgång till produktions-DB:n fortfarande kan köra en uppdaterad kopia av dokumentsidan (exempel PR). Detta kommer att slås samman efter den slutliga utgåvan.

Att faktiskt rulla ut releasen¶

OK, nu kommer den roliga delen, när vi faktiskt skickar ut en release! Om du ska skicka ut flera releaser, upprepa dessa steg för varje release.

Kontrollera att `Jenkins`__ är grön för den eller de versioner du släpper. Du bör förmodligen inte publicera en release förrän den är grön, och du bör se till att den senaste gröna körningen innehåller de ändringar som du publicerar.
Städa upp i versionsinformation för denna version. Gör dessa ändringar i main och backportera till alla grenar där versionsnoterna för en viss version finns.
1. För en funktionsutgåva, ta bort rubriken UNDER DEVELOPMENT högst upp i utgåvan, ta bort prefixet Expected och uppdatera utgivningsdatumet, om det behövs (exempel commit).
2. För en patchversion, ta bort prefixet Expected och uppdatera utgivningsdatumet för alla versioner, om nödvändigt (exempel commit).
Återskapa en ny, särskild virtuell miljö för releaseverktygen med en väntetid:
```
$ python -m pip install build twine --uploaded-prior-to=P7D
```
En release börjar alltid från en releasegren, så du bör säkerställa att du är på en uppdaterad stabil gren. Till exempel:
```
$ git checkout stable/4.1.x
$ git pull
```
Om detta är en säkerhetsrelease, slå samman lämpliga korrigeringar från django-security. Basera om dessa korrigeringar efter behov för att göra var och en till en vanlig commit på release-grenen snarare än en merge commit. För att säkerställa detta, sammanfoga dem med flaggan --ff-only; till exempel:
```
$ git checkout stable/4.1.x
$ git merge --ff-only security/4.1.x
```
(Detta förutsätter att security/4.1.x är en gren i repot django-security som innehåller de nödvändiga säkerhetsuppdateringarna för nästa utgåva i 4.1-serien)

Om git vägrar att slå samman med --ff-only, byt till security-patch grenen och rebasera den på den gren du är på väg att slå samman den med (git checkout security/4.1.x; git rebase stable/4.1.x) och byt sedan tillbaka och gör sammanslagningen. Se till att commit-meddelandet för varje säkerhetsfix förklarar att commit är en säkerhetsfix och att ett tillkännagivande kommer att följa (exempel på säkerhetsfix).
Uppdatera versionsnumret i django/__init__.py för utgåvan. Vänligen se notes on setting the VERSION tuple nedan för detaljer om VERSION (example commit).
1. Om det här är ett paket som släppts före utgivningen ska du även uppdatera trove-klassificeraren ”Development Status” i pyproject.toml för att återspegla detta. En rc-förutgåva bör inte ändra trove-klassificeringen (example commit for alpha release, example commit for beta release).
2. Annars, se till att klassificeraren är inställd på Development Status :: 5 - Produktion/Stabil.

Skapa artefakter¶

Använd eventuellt hjälpskript

Du kan förenkla några av stegen nedan med hjälpskript i katalogen scripts:

Exempelkörning av releaseskript:

$ PGP_KEY_ID=<key-id> PGP_KEY_URL=<key-url> DEST_FOLDER=~/releases scripts/do_django_release.py

Verifiera releasen (när artefakterna har laddats upp):

$ VERSION=5.2.1 scripts/verify_release.sh

Tagga utgåvan med hjälp av git tag. Till exempel:
```
$ git tag --sign --message="Tag 4.1.1" 4.1.1
```
Du kan kontrollera ditt arbete genom att köra git tag --verify <tag>.
Se till att du har ett helt rent träd genom att köra git clean -dfx.
Kör python -m build för att skapa releasepaketen. Detta skapar releaseartefakterna (tarball och wheel) i katalogen dist/.

Generera hasharna för releasepaketen:

$ cd dist
$ md5sum *
$ sha1sum *
$ sha256sum *

Skapa en ”checksums”-fil, Django-<<VERSION>>.checksum.txt som innehåller hasharna och versionsinformationen. Börja med den här mallen och infoga rätt version, datum, GPG-nyckel-ID (från gpg --list-keys --keyid-format LONG), versionshanterarens GitHub-användarnamn, versions-URL och kontrollsummor:

This file contains MD5, SHA1, and SHA256 checksums for the source-code
tarball and wheel files of Django <<VERSION>>, released <<DATE>>.

To use this file, you will need a working install of PGP or other
compatible public-key encryption software. You will also need to have
the Django release manager's public key in your keyring. This key has
the ID ``XXXXXXXXXXXXXXXX`` and can be imported from GitHub, for example,
if using the open-source GNU Privacy Guard implementation of PGP:

    curl https://github.com/<<RELEASE MANAGER GITHUB USERNAME>>.gpg | gpg --import -

Once the key is imported, verify this file:

    gpg --verify <<THIS FILENAME>>

Once you have verified this file, you can use normal MD5, SHA1, or SHA256
checksumming applications to generate the checksums of the Django
package and compare them to the checksums listed below.

Release packages
================

https://www.djangoproject.com/download/<<VERSION>>/tarball/
https://www.djangoproject.com/download/<<VERSION>>/wheel/

MD5 checksums
=============

<<MD5SUM>>  <<RELEASE TAR.GZ FILENAME>>
<<MD5SUM>>  <<RELEASE WHL FILENAME>>

SHA1 checksums
==============

<<SHA1SUM>>  <<RELEASE TAR.GZ FILENAME>>
<<SHA1SUM>>  <<RELEASE WHL FILENAME>>

SHA256 checksums
================

<<SHA256SUM>>  <<RELEASE TAR.GZ FILENAME>>
<<SHA256SUM>>  <<RELEASE WHL FILENAME>>

Signera checksummefilen (gpg --clearsign --digest-algo SHA256 Django-<version>.checksum.txt). Detta genererar ett signerat dokument, Django-<version>.checksum.txt.asc som du sedan kan verifiera med gpg --verify Django-<version>.checksum.txt.asc.

Göra utgivningen tillgänglig för allmänheten¶

Nu är du redo att faktiskt skicka ut pressmeddelandet. För att göra detta:

Skapa en ny post för Release i administrationen på djangoproject.com. Om detta är en säkerhetsrelease ska det göras 15 minuter före den aviserade releasetiden, inte tidigare:

Version
Måste överensstämma med versionsnumret enligt definitionen i tarbollen (django-<version>.tar.gz). Exempelvis ”5.2”, ”4.1.1” eller ”4.2rc1”.

Är aktiv
Ställ in på False tills releasen är helt publicerad (sista steget).

LTS
Aktivera om utgåvan är en del av en LTS-gren.

Datum
Ställ in utgivningsdatumet till idag. Den här utgåvan kommer inte att publiceras förrän is_active är aktiverat.

Artefakter
Ladda upp filerna tarball (django-<version>.tar.gz), wheel (django-<version>-py3-none-any.whl) och checksum (django-<version>.checksum.txt.asc) som skapades tidigare.
Testa att release-paketen installeras korrekt med hjälp av pip. Här är en enkel metod (den här testar bara att binärerna är tillgängliga, att de installeras korrekt och att migreringar och utvecklingsservern startar, men den kommer att upptäcka dumma misstag): https://code.djangoproject.com/wiki/ReleaseTestNewVersion.
Kör `confirm-release`__ build på Jenkins för att verifiera checksummefilerna (använd t.ex. 4.2rc1 för https://media.djangoproject.com/pgp/Django-4.2rc1.checksum.txt).
Skapa en ny token för den här releasen på PyPI och lagra den i .pypirc enligt ovan.

Ladda upp releasepaketen till PyPI:

$ twine upload --repository django dist/*

Återkalla tokenen som du nyss skapade på PyPI.
Uppdatera den nyskapade Release i administratören i djangoproject.com och aktivera flaggan is_active.
Tryck på ditt arbete och den nya taggen:
```
$ git push
$ git push --tags
```
Gör blogginlägget som tillkännager lanseringen live.
För en ny versionsutgåva (t.ex. 4.1, 4.2), uppdatera den stabila standardversionen av dokumenten genom att vända flaggan is_default till True på lämpligt DocumentRelease-objekt i databasen docs.djangoproject.com (detta kommer automatiskt att vända den till False för alla andra); du kan göra detta med webbplatsens administratör.

Skapa nya DocumentRelease-objekt för varje språk som har en post för den föregående utgåvan. Uppdatera djangoproject.com:s `robots.docs.txt`__-fil genom att kopiera resultatet som genereras genom att köra kommandot manage_translations.py robots_txt i den aktuella stabila grenen från `django-docs-translations repository`__. Till exempel, när du släpper Django 4.2:
```
$ git checkout stable/4.2.x
$ git pull
$ python manage_translations.py robots_txt
```
Skicka meddelandet om utgåvan till e-postlistan django-announce och Django Forum. Detta bör innehålla en länk till tillkännagivandets blogginlägg.
Om detta är en säkerhetsrelease ska CVE-metadata publiceras. (checklist-appen genererar JSON för detta.)
```
$ cve publish <cve-number> --cve-json-file <path-to-file>
```
Om detta är en säkerhetsrelease ska du skicka ett separat e-postmeddelande till oss-security@lists.openwall.com. Ange ”Django” samt CVE-id:n i ämnesraden. Meddelandetexten ska innehålla information om sårbarheten, till exempel texten från tillkännagivandets blogginlägg. Inkludera en länk till blogginlägget.

Efter lansering¶

Du är nästan klar! Allt som återstår att göra nu är:

Om detta inte är en förhandsutgåva, uppdatera VERSION tupeln i django/__init__.py igen, öka till vad nästa förväntade utgåva kommer att vara. Till exempel, efter att ha släppt 4.1.1, uppdatera VERSION till VERSION = (4, 1, 2, 'alpha', 0) (example commit).
Om detta var en alfautgåva:
1. Lägg till versionen för funktionsreleasen i Tracs versionslista.
2. Skapa en ny säkerhetsgren från den nyss skapade stabila grenen. Se till att hämta och uppdatera upstream till senaste version. Exempelvis efter alfautgåvan 5.2:
```
$ git fetch upstream
$ git checkout -b security/5.2.x upstream/stable/5.2.x
$ git push origin -u security/5.2.x:security/5.2.x
```
Om detta var en slutlig version:
1. Uppdatera inställningen default_version i filen trac.ini för code.djangoproject.com (exempel-PR).
2. Uppdatera den aktuella stabila grenen och ta bort förutgivningsgrenen i Djangos releaseprocess på Trac.
3. Uppdatera djangoproject.com:s nedladdningssida (exempel PR).
4. Hantera de äldre versioner som når End-Of-Mainstream- och/eller End-Of-Life-stöd när denna slutliga release publiceras:
  1. Säkerställ att EOL-versionerna nämns i blogginlägget. Se exempel på tillkännagivande.
  2. Skapa en tagg för den stabila EOL-grenen och ta bort den stabila grenen. Kontrollera och använd hjälpskriptet scripts/archive_eol_stable_branches.py.
Om detta var en säkerhetsrelease, uppdatera Arkiv över säkerhetsfrågor med detaljer om de problem som åtgärdats.
Om detta var en förhandsversion måste översättningskatalogerna uppdateras:
1. Skapa en ny gren från den nyligen utgivna stabila grenen:
```
$ git checkout stable/A.B.x
$ git checkout -b update-translations-catalog-A.B.x
```
2. Se till att releaseprogrammets dedikerade virtuella miljö är aktiverad och kör följande:
```
$ cd django
$ django-admin makemessages -l en --domain=django
processing locale en
$ django-admin makemessages -l en --domain=djangojs
processing locale en
```
3. Gör en pull request mot motsvarande stabila gren och slå samman när den har godkänts.
4. Vidarebefordra de uppdaterade källöversättningarna till huvud-grenen (exempel commit).
Om detta var en förutgåva av typen alpha ska du samordna med underhållaren av asgiref för att avgöra när minimiversionen ska höjas före den slutliga releasen. För backporten lägger du till en övre gräns för nästa huvudversion (exempelcommits: main, backport).
Om detta var en förutgåva av typen rc ska du efterlysa översättningar för den kommande releasen i Django Forum – kategorin Internationalization.

Anvisningar för inställning av VERSION-tupeln¶

Djangos versionsrapportering styrs av tupeln VERSION i django/__init__.py. Detta är en tupel med fem element, vars element är:

Större version.
Mindre version.
Mikroversion.
Status – kan vara en av ”alpha”, ”beta”, ”rc” eller ”final”.
Serienummer, för alfa/beta/RC-paket som körs i sekvens (tillåter t.ex. ”beta 1”, ”beta 2”, etc.).

För en slutlig version är statusen alltid ”final” och serienumret är alltid 0. Ett serienummer på 0 med statusen ”alpha” kommer att rapporteras som ”pre-alpha”.

Några exempel:

(4, 1, 1, "final", 0) → ”4.1.1”
(4, 2, 0, "alpha", 0) → ”4.2 pre-alpha”
(4, 2, 0, "beta", 1) → ”4.2 beta 1”

EXTENDED: Until September 14, get PyCharm for 30% off!