Настройка SS14.Watchdog

# Скачайте репозиторий SS14.Watchdog и все подмодули и т.д.
git clone --recursive https://github.com/space-wizards-federation/SS14.Watchdog

# Перейдите в директорию SS14.Watchdog.
cd SS14.Watchdog

# Соберите Watchdog.
# Результат будет помещён в: SS14.Watchdog/bin/Release/net10.0/linux-x64/publish
dotnet publish -c Release -r linux-x64 --no-self-contained

# Обычно то, что нужно, если только не используется для клиентских ZIP-архивов.
BaseUrl: "http://localhost:5000/"

Urls: "http://*:5000"

Notification:
  DiscordWebhook: "https://discord.com/api/webhooks/..."

Servers:
  Instances:
    example:
      # Это предполагаемое «человеческое» имя экземпляра.
      # На практике иногда используется в логировании.
      # Оно не влияет, например, на game.hostname.
      Name: "Example"

      # Это API-токен для внешнего доступа.
      # (В отличие от API-токена, используемого внутри между Watchdog и игровым сервером.
      #  Он генерируется случайным образом.)
      ApiToken: "you should choose a better token"

      # Несколько обманчиво — это порт игрового сервера на localhost.
      # Он НЕ будет автоматически синхронизироваться с реальным портом в конфиге.
      ApiPort: 1212

      # Тип обновления и дополнительные параметры управляют тем, откуда берётся серверное ПО.
      # Этот пример предназначен для официальных серверных сборок.
      UpdateType: "Manifest"
      Updates:
        ManifestUrl: "https://wizards.cdn.spacestation14.com/fork/wizards/manifest"

      # Ожидается, что сервер будет периодически отправлять ping Watchdog.
      # (Упомянутый выше BaseUrl передаётся серверу для этого.)
      # Это подтверждает, что сервер не упал, например.
      # Если он упал, сервер принудительно перезапускается.
      # Однако запуск может быть довольно долгим процессом на некоторых системах.
      TimeoutSeconds: 60
      # Если включено, при зависании сохраняются данные о состоянии сервера для анализа.
      # DumpOnTimeout: true
      # TimeoutDumpType управляет тем, как это настраивается, но я не уверен в деталях.

      # Программа для запуска сервера может быть задана здесь.
      # Обратите внимание, что реально это не нужно менять, если только вы:
      # A. Не пытаетесь выполнить более продвинутую диагностику (например, прикрепить отладчик)
      # B. Не делаете что-то очень непохожее на запуск сервера Space Station 14
      # RunCommand: "./wrapper.sh"

      # Переменные окружения можно задать здесь.
      # См., например, Performance Tweaks в Server Operator's Handbook.
      # EnvironmentVariables:
      #   ROBUST_NUMERICS_AVX: "true"

Servers:
  Instances:
    example:
      # (Это пример, НЕ копируйте его вслепую. Иначе вы можете получить незавершённую конфигурацию.)
      UpdateType: "Manifest"
      Updates:
        ManifestUrl: "https://wizards.cdn.spacestation14.com/fork/wizards/manifest"

Servers:
  Instances:
    example:
      # (Это пример, НЕ копируйте его вслепую. Иначе вы можете получить незавершённую конфигурацию.)
      UpdateType: "Git"
      Updates:
        # BaseUrl: URL Git-репозитория для отслеживания.
        # Он отличается от общеwatchdog'ового BaseUrl.
        BaseUrl: "https://github.com/moonheart08/outer-rim-14/"
        # Branch: Ветка для отслеживания.
        Branch: "master"
        # Hybrid ACZ: При включении игровой сервер сам размещает клиентский zip, а не watchdog.
        # С момента внедрения дельта-обновлений это теперь лучший способ обработки.
        HybridACZ: true

Servers:
  Instances:
    example:
      # (Это пример, НЕ копируйте его вслепую. Иначе вы можете получить незавершённую конфигурацию.)
      UpdateType: "Jenkins"
      Updates:
        BaseUrl: "http://localhost:9938"
        JobName: "Star"

Servers:
  Instances:
    example:
      # (Это пример, НЕ копируйте его вслепую. Иначе вы можете получить незавершённую конфигурацию.)
      UpdateType: "Dummy"

Servers:
  Instances:
    example:
      # (Это пример, НЕ копируйте его вслепую. Иначе вы можете получить незавершённую конфигурацию.)
      UpdateType: "Dummy"
      RunCommand: "./currentServer"

#!/bin/sh
rm currentServer switch inactiveBin ; mkdir -p $1
ln -s $1/Robust.Server currentServer ; ln -s $2 switch ; ln -s $3 inactiveBin
echo Switching to $1
curl -v -X POST -u myInstance:ApiToken http://localhost:5000/instances/myInstance/update

#!/bin/sh
./switchTo bin1 switchTo2 bin2

#!/bin/sh
./switchTo bin2 switchTo1 bin1

import json, datetime
nowish = datetime.datetime.now().isoformat()
print(json.dumps({"builds":{nowish: {"time": nowish, "client": {"url": "", "sha256": ""}, "server": {"linux-x64": {"url": "http://localhost:9283/SS14.Server_linux-x64.zip", "sha256": ""}}}}}))

[Unit]
Description=SS14 Watchdog
After=network.target

[Service]
ExecStart=/path/to/SS14.Watchdog
WorkingDirectory=/path/to
Restart=on-failure
# Это предотвращает отправку systemd сигнала SIGTERM watchdog'у и его завершение, если один из серверов умирает от OOM.
OOMPolicy=continue
# Это используется для git-метода, чтобы он не падал мгновенно.
Environment="DOTNET_CLI_HOME=/tmp"

[Install]
WantedBy=default.target

# Перезагрузите демон systemd (требуется при создании нового сервисного файла)
systemctl daemon-reload

# Запустите сервис Watchdog в фоне
systemctl start SS14.Watchdog

# Включите сервис Watchdog, чтобы он запускался при старте системы.
systemctl enable SS14.Watchdog

Process:
  PersistServers: true

[Service]
KillMode=process

dotnet publish -c Release -r linux-x64 --no-self-contained SS14.Watchdog -o test
 RESULT: Mono.Posix.NETStandard.dll included, System.dll not included (as expected)

dotnet publish -c Release -r linux-x64 SS14.Watchdog -o test
 RESULT: Mono.Posix.NETStandard.dll included, System.dll included

dotnet publish -c Release SS14.Watchdog -o test
 RESULT: Mono.Posix.NETStandard.dll not included, System.dll not included

Serilog:
  Using: [ "Serilog.Sinks.Console", "Serilog.Sinks.Loki" ]
  MinimumLevel:
    Default: Information
    Override:
      SS14: Information
      Microsoft: "Warning"
      Microsoft.Hosting.Lifetime: "Information"
      Microsoft.AspNetCore: Warning

  WriteTo:
    - Name: Console
      Args:
        OutputTemplate: "[{Timestamp:HH:mm:ss} {Level:u3} {SourceContext}] {Message:lj}{NewLine}{Exception}"

  Enrich: [ "FromLogContext" ]

  # Раскомментируйте, чтобы watchdog логировал в Loki
  #Loki:
  #  Address: "{{ loki_addr }}"
  #  Name: "{{ server_id }}"
  #  Username: "{{ loki_user }}"
  #  password: "{{ loki_pass }}"

AllowedHosts: "*"

Notification:
  DiscordWebhook: "https://discord.com/api/webhooks/..."

# API URL, по которому ваш watchdog доступен.
# Это ОБЯЗАТЕЛЬНО нужно установить, чтобы игровые серверы могли связываться с watchdog.
# Если вы не хотите делать watchdog публично доступным, укажите `http://localhost:5000/`.
BaseUrl: https://builds.spacestation14.io/watchdog/

Servers:
  Instances:
    # ID вашего сервера.
    wizards_den:
      # Имя сервера
      Name: "Wizard's Den"
      ApiToken: "foobar" # API-токен для удалённого управления этим экземпляром, например, запуск обновлений, перезапуск сервера.
      ApiPort: 1212 # API-порт ИГРОВОГО СЕРВЕРА. Должен совпадать с HTTP API статуса на порту 1212 (описан ниже). В противном случае watchdog не сможет связаться с игровым сервером.
      
      # Конфигурация автообновления. Можно пропустить, если автообновления не нужны. Пример для наших официально размещённых сборок.
      # Смотрите выше альтернативы.
      UpdateType: "Manifest"
      Updates:
        ManifestUrl: "https://wizards.cdn.spacestation14.com/fork/wizards/manifest"
        
      # Любые переменные окружения, которые вы можете указать.
      EnvironmentVariables:
        Foo: bar