Freigeben über

Verwalten eines Buildalias und Zuordnen zu diesem Alias

  • Artikel

Ein Buildalias ist eine Verwaltungsebene zusätzlich zu RequestMultiplayerServer Builds, mit der Aufrufe kontrolliert auf mehrere Builds verteilt werden können. Dies kann die Einfachheit und Zuverlässigkeit von Buildupgrades und mehreren anderen unten aufgeführten Szenarien verbessern. Aliase erreichen dies, indem sie eine Liste von Build-IDs zusammen mit der Gewichtung jeder einzelnen angeben. Die Gewichtung stellt das Verhältnis der Zuordnungsaufrufe dar, die an den entsprechenden Build weitergeleitet werden sollen.

Sichere Bereitstellung, die abwärtskompatibel ist

Dies ist das häufigste Szenario für ein Buildupgrade, bei dem Sie den Spieleserver aktualisieren und Einzelhandelsclients mit beiden Servern kompatibel sind.

Clients verweisen auf Alias 1, der die folgende Konfiguration aufweisen würde:

  • Build 1: Gewicht = 1

Nachdem Build 2 erstellt wurde, wird Alias 1 wie folgt geändert:

  • Build 1: Gewicht = 8
  • Build 2: Gewicht = 2

Sie können die Gewichtungen schrittweise ändern, bis alle neuen Serveranforderungen von Build 2 erfüllt sind. An diesem Punkt ist die Gewichtung für Build 1 0 und kann aus dem Alias entfernt werden.

Ein typischer Anwendungsfall für einen Alias ist die Affinität mit einer Clientkompatibilitätsversion und einem Spielmodus. Beispiel: DeathMatch-Client 2.2 RETAIL. Mit Aliasen können Sie diese Abstraktion auf höherer Ebene verwalten und gleichzeitig die Builds, die diese Erfahrung ermöglichen, kontinuierlich aktualisieren. Aliase erleichtern Ihnen auch das Rollback von Builds bei Bedarf.

Bereitstellung, die nicht abwärtskompatibel ist

In diesem Fall möchten Sie den Spieleserver gleichzeitig aktualisieren, während Sie Spieleclients aktualisieren, da Ihre aktuellen Spielclients nicht mit dem alten Serverbuild kompatibel sind. Der Übergang von einem Build zu einem anderen würde wie folgt erfolgen:

Alte Clients verweisen auf Alias 1, der Folgendes aufweisen würde:

  • Build 1: Gewicht = 1

Nachdem Build 2 erstellt wurde, verweisen neue Clients auf Alias 2, der Folgendes aufweisen würde:

  • Build 2: Gewicht = 1

In diesem Szenario werden Aliase ähnlich wie Builds verwendet, und ihre Multiplexingfunktionalität wird nicht verwendet.

Blast-Bereitstellung, die abwärtskompatibel ist

Dies ähnelt dem abwärtskompatiblen Build-zu-Build-Upgradeszenario, jedoch mit einem plötzlicheren Wechsel des Nachfrageverhaltens. Der Übergang von einem Build zu einem anderen würde wie folgt erfolgen:

Clients verweisen auf Alias 1, der Folgendes aufweisen würde:

  • Build 1: Gewicht = 1

Nachdem Build 2 erstellt wurde, wird Alias 1 wie folgt geändert:

  • Build 1: Gewicht = 0
  • Build 2: Gewicht = 1

Testen einer abwärtskompatiblen Bereitstellung

Wenn Sie den Spielserver aktualisieren möchten und die Clientversion mit beiden Servern kompatibel ist, Sie aber die zweite Version testen möchten, bevor Sie sie im großen Stil für alle Spieler bereitstellen. Das Testen und Wechseln von einem Build zu einem anderen kann wie folgt erfolgen:

Clients verweisen auf Alias 1, der Folgendes aufweisen würde:

  • Build 1: Gewicht = 1

Nachdem Build 2 erstellt wurde. Testclients verweisen auf Alias 2, der Folgendes aufweisen würde:

  • Build 2: Gewicht = 1

Nachdem Build 2 überprüft wurde. Alias 1 wird wie folgt geändert:

  • Build 1: Gewicht = 8
  • Build 2: Gewicht = 2

Nach und nach würde Build 2 stärker gewichtet und den gesamten Datenverkehr aufnehmen.

Fallback auf andere Builds und Regionen

Aliase können Ihre Multiplayerserverbereitstellungen resilienter machen, indem sie Fallbacks über mehrere Builds hinweg ermöglichen. Angenommen, eine Zuordnungsanforderung, die auf einen Buildalias abzielt, stuft EastUS als Region #1 und USA, Westen als Region 2 ein. Dieser Buildalias bietet ähnliche Gewichtungen wie zwei Builds, Build 1 und Build 2.

Angenommen, für eine bestimmte Zuordnung ist Build 1 ausgewählt.

  1. Die Zuordnung in "USA, Osten" für Build 1 wird versucht.
  2. Wenn Nr. 1 fehlschlägt, wird die Zuordnung in "USA, Osten" für Build 2 versucht.
  3. Wenn Nr. 2 fehlschlägt, wird die Zuordnung in WestUS für Build 1 versucht.
  4. Wenn Nr. 3 fehlschlägt, wird die Zuordnung in WestUs für Build 2 versucht.

Insbesondere da Sie schrittweise von einem Build auf einen anderen upgraden, ist dieses Fallbackverhalten optimiert, sodass Spieler den Server mit der geringsten Latenz erhalten, auch wenn einer der Builds Probleme hat.

Verwalten eines Buildalias mit PlayFab-REST-APIs

Notiz

Sie können jetzt Buildaliase in Game Manager verwalten. Informationen zu den ersten Schritten finden Sie auf der Übersichtsseite für Builds.

  1. Erstellen Sie mithilfe der API einen Buildalias.

    API:

    POST https://titleId.playfabapi.com/MultiplayerServer/CreateBuildAlias

    Beispieltext:

    {
    "AliasName":"TestingAlias",
    "BuildSelectionCriteria":
    [{
        "BuildWeightDistribution":{"9a8a4584-c81a-479c-9ef9-16d3743f7ca7":"1"}
    }]
}

    Beispielantwort:

    {
    "AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6",
    "AliasName":"TestingAlias",
    "BuildSelectionCriteria":
    [{
        "BuildWeightDistribution":{"9a8a4584-c81a-479c-9ef9-16d3743f7ca7":"1"}
    }]
}

    Die Buildalias-ID wird als Teil der Antwort bereitgestellt.

  2. Aktualisieren Sie jeden Parameter des Buildalias.

    API:

    POST https://titleId.playfabapi.com/MultiplayerServer/UpdateBuildAlias

    Beispieltext:

    {
    "AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6",
    "AliasName":"TestingAliasRenamed",
    "BuildSelectionCriteria":
    [{
        "BuildWeightDistribution":{"9a8a4584-c81a-479c-9ef9-16d3743f7ca7":"1",
        "7ac7f347-3d61-9fe9-c974-a18c4854a8a9":"1"}
    }]
}

    Beispielantwort:

    {
    "AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6",
    "AliasName":"TestingAliasRenamed",
    "BuildSelectionCriteria":
    [{
        "BuildWeightDistribution":{"9a8a4584-c81a-479c-9ef9-16d3743f7ca7":"1",
        "7ac7f347-3d61-9fe9-c974-a18c4854a8a9":"1"}
    }]
}

  3. Löschen eines Buildalias.

    API:

    POST https://titleId.playfabapi.com/MultiplayerServer/DeleteBuildAlias

    Beispieltext:

    {
    "AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6"
}

  4. Auflisten von Buildaliasen.

    API:

    GET https://titleId.playfabapi.com/MultiplayerServer/ListBuildAliases

    Beispielantwort:

    [{
    "AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6",
    "AliasName":"TestingAliasRenamed",
    "BuildSelectionCriteria":
    [{
        "BuildWeightDistribution":{"9a8a4584-c81a-479c-9ef9-16d3743f7ca7":"1",
        "7ac7f347-3d61-9fe9-c974-a18c4854a8a9":"1"}
    }]
}]

Zuordnen mithilfe eines Buildalias

Zum Zuordnen mithilfe eines Buildalias muss einfach die Buildalias-ID im RequestMultiplayerServer Aufruf angegeben werden.

API:

POST https://titleId.playfabapi.com/MultiplayerServer/RequestMultiplayerServer

Beispieltext:

{
    "SessionId":"6a07440c-7bcc-4e23-8b81-4934543ff966",
    "PreferredRegions":["SouthCentralUs"],
    "BuildAliasParams":
        {"AliasId":"97d2b0a5-7c04-4593-8451-66bbb97f94b6"}
}