Releasen vanuit CI
Een release zet bestanden uit je build in je templates. Tag hem v1.4.2 en elke template die hij noemt krijgt een nieuwe versie. Zet een streepje in de tag, zoals v1.5.0-beta.1, en elke template krijgt een concept dat iemand vanuit het paneel publiceert. Een bestand dat sinds de vorige versie niet veranderd is, voegt niets toe.
Een token maken
Open in het paneel Instellingen, Mensen, Tokens en maak een CI-token. Kies de templates waarnaar het mag publiceren. Het paneel toont het token één keer, dus sla het meteen op als het CI-geheim ATLAS_TOKEN.
Een persoonlijke token, onder Profiel, Tokens, heeft alleen een naam. Hij handelt als jou, met de rol die je hebt op het moment dat hij gebruikt wordt, en atlasDev heeft hem nodig.
De release versturen
on:
push:
tags: ["v*"]
jobs:
release:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
- run: ./gradlew build
- uses: getatlasgg/publish@v1
with:
panel: https://panel.example.net
token: ${{ secrets.ATLAS_TOKEN }}
files: |
games/dusty-dunes:plugins/DustyDunes.jar = build/libs/DustyDunes.jarVul het adres van het paneel en het token in, en zet elk bestand op een eigen regel. De Action leest de tag en de link naar de commit uit de push.
Een build proberen op een dev-server
Terwijl je aan een plugin werkt, stuurt ./gradlew atlasDev de build naar een concept in plaats van een release. Zet server aan om hem ook te draaien:
atlas {
publish("games/survival-games", "plugins/SG.jar", tasks.shadowJar)
dev { server = true }
}atlasDev logt in met een persoonlijke token. Maak er een onder Profiel, Tokens en zet hem als ATLAS_TOKEN. Een CI-token uit Instellingen kan niet naar een concept pushen.
De build gaat naar het concept dat je in het paneel als laatste opende, maakte of wijzigde, één per template. Open een ander concept en de volgende build komt daar terecht. Heb je nog geen concept op een template, dan maakt de eerste build er een met de naam van de template en van jou, zoals survival-games-esmay. Wil je voor één build een concept op naam kiezen, voeg dan -Patlas.draft=<naam> toe.
Met server aan start Atlas de dev-server van het concept, of herstart hem als hij al draait. Het gebruikt de groep van die dev-server, of de groep die je als laatste in het paneel opende. Is je Minecraft-account gekoppeld, dan stuurt de proxy je naar de server zodra hij draait.
Een build vervangt alleen de bestanden die hij noemt, dus config die je in het concept aanpaste blijft staan. Heeft iemand gepubliceerd sinds je concept begon, dan werkt Atlas het concept eerst bij. Botsen je bestanden met de live versie, dan komt de build toch aan en noemt Gradle het concept, zodat je in het paneel een kant kiest. atlasPublish en de Action releasen zoals hierboven beschreven.
Welk bestand waar komt
Elk bestand is één regel in de vorm template:path = file.
| Deel | Wat het is |
|---|---|
template |
De naam van de template, zoals games/dusty-dunes |
path |
Waar het bestand in de template komt, zoals plugins/DustyDunes.jar |
file |
Het bestand dat je build maakte |
Een release met meerdere bestanden publiceert ze allemaal of geen enkele.
Versies dicht bij elkaar houden
De voorbeelden op deze pagina tonen altijd de nieuwste release. Een paneel neemt releases aan van de CLI of de Gradle-plugin van zijn eigen minor-versie, of de versie daarvoor. Werk ze dus bij wanneer je het paneel bijwerkt.