User Tools

Site Tools


gamedev:gameci

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
gamedev:gameci [2022/06/08 11:40] dragonlordgamedev:gameci [2022/07/01 16:55] (current) – [Jenkins] dragonlord
Line 24: Line 24:
   * [[https://github.com/LordOfDragons/dragengine/releases/download/nightly/install-dragengine-ci-nightly-linux64.sh|install-dragengine-ci-latest.sh]]   * [[https://github.com/LordOfDragons/dragengine/releases/download/nightly/install-dragengine-ci-nightly-linux64.sh|install-dragengine-ci-latest.sh]]
   * [[https://github.com/LordOfDragons/dragengine/releases/download/nightly/install-deigde-ci-nightly-linux64.sh|install-deigde-ci-latest.sh]]   * [[https://github.com/LordOfDragons/dragengine/releases/download/nightly/install-deigde-ci-nightly-linux64.sh|install-deigde-ci-latest.sh]]
 +
 +This downloads the latest nightly build. You can also use regular release versions from [[https://github.com/LordOfDragons/dragengine/releases|Drag[en]gine Releases]]. The files are named <wrap hi>install-dragengine-ci-{version}.sh</wrap> and <wrap hi>install-deigde-ci-{version}.sh</wrap>.
  
 Except from being UI-less it behaves the same for console use as the regular IGDE. Except from being UI-less it behaves the same for console use as the regular IGDE.
Line 29: Line 31:
 The sections below show some examples on how to use this in CI-Systems. The sections below show some examples on how to use this in CI-Systems.
  
-====== Docker ======+===== Docker ===== 
 +{{ :gamedev:docker.png?direct |Docker Logo}}
  
 A docker image is ready made to be used: [[https://hub.docker.com/repository/docker/lordofdragons/deigde-ci|Docker Image DEIGDE-CI]]. The ready made docker image contains the most recent stable release. A docker image is ready made to be used: [[https://hub.docker.com/repository/docker/lordofdragons/deigde-ci|Docker Image DEIGDE-CI]]. The ready made docker image contains the most recent stable release.
  
 +To run the docker image use a command line like this:
 +<code bash>docker run -it --rm --volume=/home/user/deprojects/MyGame:/project lordofdragons/deigde-ci /project/MyGame.degp --project.profile.distribute Release</code>
 +
 +The *.delga file is then located in the path <wrap hi>/home/user/deprojects/MyGame/{path-delga}</wrap> whereas <wrap hi>{path-delga}</wrap> is the path set in the profile <wrap hi>Release</wrap>.
 +
 +==== Custom Docker Image ====
 If you want to integrate the IGDE-CI directly into your docker build image you can do this with the following run commands: If you want to integrate the IGDE-CI directly into your docker build image you can do this with the following run commands:
 <code dockerfile> <code dockerfile>
Line 48: Line 57:
 Adjust DE_RELEASE_VERSION to the Drag[en]gine release version to use. This script requires "curl", "tar" and "bzip2" to be present otherwise it fails. Adjust DE_RELEASE_VERSION to the Drag[en]gine release version to use. This script requires "curl", "tar" and "bzip2" to be present otherwise it fails.
  
-To run the docker image use a command line like this: +===== GitHub Actions ===== 
-<code bash>docker run -it --rm --volume=/home/user/deprojects/MyGame:/project lordofdragons/deigde-ci /project/MyGame.degp --project.profile.distribute Release</code> +{{ :gamedev:githubactions.png?direct |Github Actions Logo}}
- +
-The *.delga file is then located in the path "/home/user/deprojects/MyGame/<path-delga>" whereas "<path-delga>" is the path set in the profile "Release"+
- +
-====== GitHub Actions ======+
  
 For GitHub Actions a ready made action is provided: [[https://github.com/marketplace/actions/build-delga|Build DELGA distribution docker action]]. This action allows to run the distribute command. To use the action checkout the game project from your repository then include this code in your build script: For GitHub Actions a ready made action is provided: [[https://github.com/marketplace/actions/build-delga|Build DELGA distribution docker action]]. This action allows to run the distribute command. To use the action checkout the game project from your repository then include this code in your build script:
Line 89: Line 94:
 </code> </code>
  
-The upcoming build scripts can then use the distribution file with the path "distribute/MyGame.delgagiven this is the path stored in the profile "Release".+The upcoming build scripts can then use the distribution file with the path <wrap hi>distribute/MyGame.delga</wrap> given this is the path stored in the profile <wrap hi>Release</wrap>. 
 + 
 +==== Custom Actions Script ====
  
 If you do not want to use the provided action, for example to use commands beyond building the distribution file, you can either use the docker image from the previous section or you can install the IGDE-CI into the running VM instance like this: If you do not want to use the provided action, for example to use commands beyond building the distribution file, you can either use the docker image from the previous section or you can install the IGDE-CI into the running VM instance like this:
Line 105: Line 112:
 </code> </code>
  
-Then you can use "deigdecommand directly.+Then you can use <wrap hi>deigde</wrap> command directly.
  
-====== Jenkins ======+===== Jenkins ===== 
 +{{ :gamedev:jenkins.png?direct |}}
  
 For Jenkins it is recommended to use the docker image mentioned above. You can also install the IGDE-CI directly into your build system as outline in the previous section. It is though easier to use the ready made docker image. For Jenkins it is recommended to use the docker image mentioned above. You can also install the IGDE-CI directly into your build system as outline in the previous section. It is though easier to use the ready made docker image.
  
gamedev/gameci.1654688411.txt.gz · Last modified: 2022/06/08 11:40 by dragonlord