Versiebeheer

Magdalena Skarbińska
Magdalena Skarbińska
Demián Renzulli
Demián Renzulli

Geïsoleerde web-apps (GWA's) bieden een zeer betrouwbare, beveiligde en versiediscrete runtimeomgeving bovenop het webplatform. In productieomgevingen, met name binnen beheerde bedrijven, hebben beheerders en ontwikkelaars gedetailleerde controle nodig over software-implementaties.

Chrome biedt uitgebreide mogelijkheden voor versiebeheer voor IWA's om aan deze vereisten te voldoen, waaronder updatekanalen, versies vastzetten en versies downgraden. Met deze functies kun je de implementatie voorspellen en snel herstelopties gebruiken voor je gebruikersbestand.

Beschikbaarheid

Het gedrag van versiebeheer hangt af van of de IWA wordt beheerd door een beheerder of rechtstreeks door een gebruiker is geïnstalleerd:

  • Beheerde GWA's: Beheerfuncties (waaronder beleidsgestuurd vastzetten en downgrades) zijn beschikbaar vanaf Chrome 133.
  • Onbeheerde (door de gebruiker geïnstalleerde) GWA's: Op gebruikers gerichte functies (zoals handmatige kanaalselectie) zijn beschikbaar vanaf Chrome 150.

Compatibiliteit van sessietype

Alle functies voor versiebeheer, waaronder updatekanalen en versies vastzetten, zijn volledig compatibel met alle ChromeOS-sessietypen. Bijvoorbeeld:

  • Standaard beheerde gebruikerssessies
  • Beheerde gastsessies (MGS)
  • Speciale omgevingen voor de kioskmodus

Kanalen updaten

Met updatekanalen kunnen ontwikkelaars specifieke app-builds segmenteren voor verschillende implementatie- en testdoelgroepen. Als je kanalen wilt instellen, voeg je een optioneel veld voor een kanaalmatrix toe aan elke versie-invoer in het updatemanifest van de app. Deze kanaalnamen zijn niet beperkt tot vaste platformzoekwoorden (zoals canary of stable), maar zijn willekeurige, door de ontwikkelaar gedefinieerde ID's die moeten worden opgemaakt als alfanumerieke ASCII-tekenreeksen in kleine letters (die koppeltekens of underscores kunnen bevatten, maar geen spaties). Als een versie-item het veld met kanalen helemaal weglaat, gebruikt Chrome impliciet standaard de beschikbaarheid van het standaardkanaal. Uiteindelijk moet de kanaalnaam die in het beheerdersbeleid is aangegeven, exact overeenkomen met de tekenreeks die in het manifest is gedefinieerd. Typfouten of onjuiste configuraties leiden ertoe dat er geen in aanmerking komende versie wordt gevonden, waardoor updates voor die clients worden stopgezet.

Manifestconfiguratie

Als je kanalen wilt instellen, voeg je een optionele channels-matrix toe aan elke versie-invoer in je web-app-manifest. Houd rekening met het volgende:

  • Kanaaltoewijzing: Als een versie-item een channels-matrix definieert, komt die versie alleen in aanmerking voor installatie op de aangegeven kanalen.
  • De standaard fallback: Als een versie-item het veld channels helemaal weglaat, gaat Chrome ervan uit dat de versie uitsluitend bij het kanaal default hoort.
  • Exact zoeken: Kanaalnamen die zijn opgegeven in beleidsconfiguraties aan de clientzijde moeten exact overeenkomen met de tekenreeksen die zijn gedefinieerd in het updatemanifest (hoofdlettergevoelig). Als er geen versie overeenkomt met de naam van het getargete kanaal, kan de app geen in aanmerking komende updates vinden.

Voorbeeld van updatemanifest

In het volgende voorbeeld zie je een updatemanifest dat meerdere releasekanalen ondersteunt:

{
  "versions": [
    {
      "version": "0.1.0",
      "src": "https://github.com/chromeos/iwa-sink/releases/download/v0.1.0/iwa-sink.swbn",
      "channels": ["delta"]
    },
    {
      "version": "0.2.0",
      "src": "https://github.com/chromeos/iwa-sink/releases/download/v0.2.0/iwa-sink.swbn",
      "channels": ["delta", "default"]
    },
    {
      "version": "0.3.0",
      "src": "https://github.com/chromeos/iwa-sink/releases/download/v0.3.0/iwa-sink.swbn",
      "channels": ["beta", "delta"]
    },
    {
      "version": "0.4.0",
      "src": "https://github.com/chromeos/iwa-sink/releases/download/v0.4.0/iwa-sink.swbn"
    }
  ]
}

Op basis van dit manifest zijn de volgende versies beschikbaar per getarget kanaal:

  • default: 0.2.0,0.4.0 (die geen expliciet kanaal heeft en standaard wordt ingesteld op default)
  • delta: 0.1.0, 0.2.0, 0.3.0
  • bèta: 0.3.0

De IWA-update-engine ondersteunt targeting op specifieke releasekanalen door te zoeken naar een kanaalveld in het updatemanifest van de app.

Versie vastzetten

In bedrijfsomgevingen met een hoge mate van naleving of stabiliteit moeten beheerders ervoor zorgen dat apparaten de exacte versies van bedrijfskritieke software uitvoeren. Met versievastzetting kunnen beheerders een GWA vastzetten op een specifieke versie, waardoor alle volgende achtergrondupdates worden gestopt. Zo hebben bedrijven een zeer betrouwbare manier om stabiele configuraties te behouden en te voldoen aan strenge interne of branchevoorschriften.

Als zakelijke beheerders een geïsoleerde web-app (IWA) willen vastzetten op een specifieke release-build, kunnen ze de property pinned_version instellen in het beleid IsolatedWebAppInstallForceList. Deze mogelijkheid wordt voornamelijk beheerd via de interactieve UI-bedieningselementen in de Google Beheerdersconsole in het detailvenster van de app volgens de standaard IWA-installatieworkflow. Beheerders kunnen deze beleidswaarden ook rechtstreeks implementeren met onbewerkte json-configuraties. Nadat de beheerder een geldige versietekenreeks heeft getarget, haalt Chrome dat expliciete pakket op en blokkeert alle daaropvolgende automatische updates.

Speciaal gedrag en beperkingen

  • Updates hervatten (losmaken): Als je automatische updates wilt herstellen, verwijder je de property pinned_version of wijzig je de waarde in een nieuwere doelversie.
  • Standaard geen downgrade: Als je pinned_version instelt op een lagere versie dan de op dit moment geïnstalleerde versie, wordt er geen rollback geactiveerd, tenzij allow_downgrades expliciet aanstaat.
  • Niet-beschikbare vastzetdoelen: Als de ingestelde pinned_version ontbreekt in het aangewezen updatekanaal of ouder is dan de geïnstalleerde versie (met downgrades uitgeschakeld), behoudt Chrome de huidige geïnstalleerde versie en worden verdere updates geblokkeerd.
  • Nieuwe implementaties: Als een GWA nog niet is geïnstalleerd op een beheerd apparaat en de opgegeven pinned_version niet kan worden opgehaald of ontbreekt in het updatemanifest, kan de GWA niet worden geïnstalleerd.

Versie downgraden

Als een nieuwe update een kritieke bug of kwetsbaarheid introduceert, moeten beheerders apparaten misschien terugzetten naar een eerdere stabiele status. Chrome ondersteunt het downgraden van al geïnstalleerde beheerde GWA's naar een lagere versie. Deze mogelijkheid was eerder niet beschikbaar op het platform toen alleen updates naar nieuwere versies waren toegestaan.

Downgraden is alleen mogelijk als aan beide van de volgende beleidsvoorwaarden wordt voldaan:

  1. pinned_version is ingesteld op een geldige, oudere versie.
  2. allow_downgrades is expliciet ingesteld op true.

Hoe downgrades werken

  • Triggermechanisme: Terugdraaiingen worden verwerkt tijdens de normale updatecontrolecyclus (die elke 4 tot 6 uur wordt uitgevoerd).
  • Achter de schermen: Chrome voert een volledige herinstallatie van de IWA uit met de oudere webbundel (.swbn) die is aangegeven in het updatemanifest.

Logica voor kanaalovergang

Als je het doelgroeptype van een app wijzigt met een beleidsregel, houdt de update-engine zich aan specifiek gedrag:

Scenario A: Overschakelen naar een kanaal met eerdere versies

  • Als downgraden is toegestaan: Als pinned_version overeenkomt met een oudere versie op het doelkanaal en allow_downgrades waar is, wordt een rollback uitgevoerd (en worden lokale gebruikersgegevens gewist).
  • Als downgraden niet is toegestaan: Er vindt geen downgrade plaats. Het apparaat blijft op de huidige geïnstalleerde hogere versie en wordt alleen geüpdatet als er een nieuwere versie beschikbaar komt op het nieuw geselecteerde kanaal.

Scenario B: Overschakelen naar een kanaal met een identieke versie

  • Geen wijzigingen: Als het nieuw geselecteerde kanaal verwijst naar een versienummer dat gelijk is aan het momenteel geïnstalleerde kanaal, brengt Chrome geen wijzigingen aan in de geïnstalleerde bundel.
  • Byte-by-byte-identiteitsprincipe: Ontwikkelaars moeten garanderen dat identieke versienummers op verschillende kanalen identieke, byte-overeenkomende codehandtekeningen bevatten. Als je verschillende codebases onder dezelfde versietekenreeks implementeert op verschillende kanalen, kan dit leiden tot onverwachte, onregelmatige app-statussen.

Beheerbeleid instellen

Zakelijke versiebeheeropties worden afgedwongen via het gecentraliseerde Google Beheerdersconsole-platform met het beleidsschema IsolatedWebAppInstallForceList. Je kunt deze instellingen rechtstreeks beheren via bedieningselementen in de Beheerdersconsole of implementeren met onbewerkte json-beleidsconfiguraties.
In het volgende voorbeeld van een configuratie van beheerdersbeleid zie je updatekanalen, vastgezette versies en downgrades:

Weergave van beleidswaarde

[
  {
    "update_manifest_url": "https://awesome-kitchen-sink.glitch.me/update.json",
    "web_bundle_id": "aiv4bxauvcu3zvbu6r5yynoh4atkzqqaoeof5mwz54b4zfywcrjuoaacai",
    "channel": "beta",
    "pinned_version": "0.7.0",
    "allow_downgrades": true
  }
]

Uitleg van schemaparameters

  • channel (tekenreeks, optioneel): Geeft Chrome de instructie om alleen versies te evalueren die aan dit kanaal zijn toegewezen in het updatemanifest. Als je dit weglaat, evalueert Chrome het kanaal 'default'.
  • pinned_version (tekenreeks, optioneel): Vergrendelt het apparaat expliciet op de opgegeven versietekenreeks. Daarna worden automatische updates op de achtergrond geblokkeerd.
  • allow_downgrades (boolean, optioneel): Hiermee zet je de terugdraaimogelijkheid aan. Als dit waar is en is gekoppeld aan een geldige, oudere pinned_version, activeert Chrome een downgrade-herinstallatie. Waarschuwing: Als je deze parameter instelt op true, worden alle standaard updates voor doorsturen geblokkeerd, zelfs als het veld pinned_version wordt weggelaten.

Onbeheerde (door de gebruiker geïnstalleerde) GWA's (vanaf versie 150)

Voor niet-beheerde, door gebruikers geïnstalleerde geïsoleerde web-apps werkt versiebeheer met handmatige gebruikersinteracties:

Installatiepakket ──► Gebruiker selecteert kanaal ──► Automatische controles op geselecteerd kanaal

Manifestvereiste voor automatische updates

Als je wilt dat door gebruikers geïnstalleerde IWA's op de achtergrond controleren op automatische periodieke updates en deze ontvangen, moet het lokale web-app-manifest van de app (de metadata die in de bundel is verpakt op /.well-known/manifest.webmanifest) een geldig veld update_manifest_url bevatten.

Als deze URL wordt weggelaten uit het lokale manifestbestand van de app, voert de onbeheerde update-engine nooit achtergrondcontroles uit en blijft de app permanent vaststaan op de oorspronkelijke installatieversie.

Handmatige kanaalselectie

Tijdens de eerste installatie van een onbeheerde IWA controleert de browser het updatemanifest en toont de beschikbare kanaalopties (bijvoorbeeld Stabiel, Bèta) rechtstreeks aan de gebruiker als de ontwikkelaar meerdere kanalen heeft ingesteld.

Belangrijke levenscyclusregels

  1. Oorsprong van de eerste installatie: Ongeacht het kanaal dat de gebruiker selecteert bij de installatie, worden bij de eerste installatie altijd de bestanden geïmplementeerd die zijn verpakt in de meegeleverde installatiebundel.
  2. Volgende updates: Na de installatie worden toekomstige updates uitsluitend opgevraagd via het gekozen kanaal. De app wordt alleen geüpdatet als er een versie die hoger is dan de geïnstalleerde versie, wordt gepubliceerd op dat doelgroeptype.
  3. Wisselen van kanaal: Als de gebruiker na de installatie wil overschakelen naar een ander updatekanaal, moet die de GWA verwijderen en opnieuw installeren. Tijdens het installatieproces moet de gebruiker dan het geselecteerde kanaal kiezen.

Beheerde implementaties testen

Voor beheerders die apparaten beheren via de Chrome Enterprise-beheerdersconsole of die beleid rechtstreeks instellen:

  1. Ga naar het deelvenster App-gegevens onder de organisatie-instellingen.
  2. Configuratie-eigenschappen toepassen om vastzetten en kanaaldoelen te testen. Omdat deze bedieningselementen volledig compatibel zijn met standaard gebruikerssessies, beheerde gastsessies en kiosken, kun je het gedrag in alle doelimplementatieomgevingen verifiëren.
  3. Als je updatecontroles lokaal wilt inspecteren, ga je naar chrome://web-app-internals op een testclient om handmatig updatecontroles af te dwingen en inkomende manifestpakketten te analyseren.

Conclusie

De beveiligingsarchitectuur van geïsoleerde web-apps is ontworpen om ontwikkelaars meer mogelijkheden te geven en tegelijkertijd strikte voorspelbaarheid en controle over het gedrag van de app-levenscyclus te behouden. Met de functies voor versiebeheer van Chrome kunnen zowel ontwikkelaars als IT-beheerders robuuste implementatiepipelines bouwen die voldoen aan strenge compliancenormen en operationele doelen.

Houd rekening met deze kernprincipes als u de updatestrategie van uw app ontwerpt en beheert:

  • Gebruik progressieve kanalen: Met updatekanalen (zoals beta, dev of aangepaste ringen) kun je geleidelijk telemetrie en feedback verzamelen. Zo zorgen we dat belangrijke updates grondig worden geverifieerd voordat ze de algemene bevolking bereiken via het standaardkanaal.
  • Vastzetten voor stabiliteit: In zeer gestructureerde of nalevingsgerichte bedrijfsomgevingen vergrendel je kritieke eindpunten aan een geverifieerde, exacte pinned_version om de bedrijfsvoering te beschermen tegen onverwachte onderbrekingen of workflowonderbrekingen.
  • Bewaar downgrades voor noodgevallen: Een versiedowngrade is een krachtige, corrigerende veiligheidsklep die eerder onmogelijk was. Omdat een rollback een volledige herinstallatie activeert en alle lokale clientopslag (IndexedDB, LocalStorage, cookies) wist, moet deze strikt worden gereserveerd voor kritieke beveiligingsherstelacties. Voor gewone patches is het altijd de beste strategie om een kleine, toekomstgerichte update te implementeren.
  • Inzicht in beleidsmarkeringen: Let op de beheerschakelaars. Als je allow_downgrades aanzet, worden alle updates vooruit gestopt, zelfs als een vastgezette versie niet actief is gedefinieerd.
  • Zorg voor byte-voor-byte-integriteit: Zorg dat identieke versienummers die op verschillende kanalen zijn geïmplementeerd, worden toegewezen aan identieke, byte-overeenkomende bundels om onregelmatige app-statussen te voorkomen wanneer clients tussen kanalen wisselen.

Door deze functies rechtstreeks te integreren in je updatemanifest en zakelijke beleidsschema, zorg je voor een betrouwbaar, controleerbaar en beveiligd updateproces dat de garanties voor een hoog vertrouwen van het ecosysteem van geïsoleerde web-apps behoudt.