diff --git a/docs/03-github/01-getting-started.mdx b/docs/03-github/01-getting-started.mdx index ca066747..82219a9d 100644 --- a/docs/03-github/01-getting-started.mdx +++ b/docs/03-github/01-getting-started.mdx @@ -76,12 +76,12 @@ jobs: steps: # Checkout - name: Checkout repository - uses: actions/checkout@v2 + uses: actions/checkout@v3 with: lfs: true # Cache - - uses: actions/cache@v2 + - uses: actions/cache@v3 with: path: Library key: Library-${{ hashFiles('Assets/**', 'Packages/**', 'ProjectSettings/**') }} @@ -107,7 +107,7 @@ jobs: targetPlatform: WebGL # Output - - uses: actions/upload-artifact@v2 + - uses: actions/upload-artifact@v3 with: name: Build path: build @@ -131,14 +131,14 @@ jobs: steps: # Checkout (without LFS) - name: Checkout repository - uses: actions/checkout@v2 + uses: actions/checkout@v3 # Git LFS - name: Create LFS file list run: git lfs ls-files -l | cut -d' ' -f1 | sort > .lfs-assets-id - name: Restore LFS cache - uses: actions/cache@v2 + uses: actions/cache@v3 id: lfs-cache with: path: .git/lfs @@ -151,7 +151,7 @@ jobs: git reset --hard # Cache - - uses: actions/cache@v2 + - uses: actions/cache@v3 with: path: Library key: Library-${{ hashFiles('Assets/**', 'Packages/**', 'ProjectSettings/**') }} @@ -177,7 +177,7 @@ jobs: targetPlatform: WebGL # Output - - uses: actions/upload-artifact@v2 + - uses: actions/upload-artifact@v3 with: name: Build path: build @@ -219,11 +219,11 @@ jobs: - Android # Build an Android player. - WebGL # WebGL. steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 with: fetch-depth: 0 lfs: true - - uses: actions/cache@v2 + - uses: actions/cache@v3 with: path: ${{ matrix.projectPath }}/Library key: @@ -241,11 +241,13 @@ jobs: projectPath: ${{ matrix.projectPath }} unityVersion: ${{ matrix.unityVersion }} githubToken: ${{ secrets.GITHUB_TOKEN }} - - uses: actions/upload-artifact@v2 + - uses: actions/upload-artifact@v3 if: always() with: name: Test results (all modes) path: ${{ steps.testRunner.outputs.artifactsPath }} + - if: matrix.targetPlatform == 'Android' + uses: jlumbroso/free-disk-space@v1.2.0 - uses: game-ci/unity-builder@v2 env: UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }} @@ -256,7 +258,7 @@ jobs: unityVersion: ${{ matrix.unityVersion }} targetPlatform: ${{ matrix.targetPlatform }} customParameters: '-myParameter myValue -myBoolean -ThirdParameter andItsValue' - - uses: actions/upload-artifact@v2 + - uses: actions/upload-artifact@v3 with: name: Build path: build @@ -279,11 +281,11 @@ jobs: - WSAPlayer # Build a UWP App. steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 with: fetch-depth: 0 lfs: true - - uses: actions/cache@v2 + - uses: actions/cache@v3 with: path: ${{ matrix.projectPath }}/Library key: @@ -303,7 +305,7 @@ jobs: unityVersion: ${{ matrix.unityVersion }} targetPlatform: ${{ matrix.targetPlatform }} customParameters: '-myParameter myValue -myBoolean -ThirdParameter andItsValue' - - uses: actions/upload-artifact@v2 + - uses: actions/upload-artifact@v3 with: name: Build path: build @@ -323,12 +325,12 @@ jobs: - StandaloneOSX # Build a macOS standalone. steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 with: fetch-depth: 0 lfs: true - - uses: actions/cache@v2 + - uses: actions/cache@v3 with: path: ${{ matrix.projectPath }}/Library key: @@ -350,7 +352,7 @@ jobs: targetPlatform: ${{ matrix.targetPlatform }} customParameters: '-myParameter myValue -myBoolean -ThirdParameter andItsValue' - - uses: actions/upload-artifact@v2 + - uses: actions/upload-artifact@v3 with: name: Build path: build diff --git a/docs/03-github/04-builder.mdx b/docs/03-github/04-builder.mdx index c4038062..fe7755fd 100644 --- a/docs/03-github/04-builder.mdx +++ b/docs/03-github/04-builder.mdx @@ -554,21 +554,23 @@ jobs: - Android # Build an Android .apk standalone app. - WebGL # WebGL. steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 with: fetch-depth: 0 lfs: true - - uses: actions/cache@v2 + - uses: actions/cache@v3 with: path: Library key: Library-${{ matrix.targetPlatform }} restore-keys: Library- + - if: matrix.targetPlatform == 'Android' + uses: jlumbroso/free-disk-space@v1.2.0 - uses: game-ci/unity-builder@v2 env: UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }} with: targetPlatform: ${{ matrix.targetPlatform }} - - uses: actions/upload-artifact@v2 + - uses: actions/upload-artifact@v3 with: name: Build-${{ matrix.targetPlatform }} path: build/${{ matrix.targetPlatform }} diff --git a/docs/03-github/06-deployment/android.mdx b/docs/03-github/06-deployment/android.mdx index 7b4abff9..6fca0f8a 100644 --- a/docs/03-github/06-deployment/android.mdx +++ b/docs/03-github/06-deployment/android.mdx @@ -166,8 +166,9 @@ jobs: name: Build For Android Platform runs-on: ubuntu-latest steps: - - uses: actions/checkout@v2 - - uses: actions/cache@v2 + - uses: jlumbroso/free-disk-space@v1.2.0 + - uses: actions/checkout@v3 + - uses: actions/cache@v3 with: path: Library key: Library-Android @@ -181,7 +182,7 @@ jobs: androidKeyaliasName: ${{ secrets.ANDROID_KEYALIAS_NAME }} androidKeyaliasPass: ${{ secrets.ANDROID_KEYALIAS_PASS }} androidTargetSdkVersion: AndroidApiLevel31 - - uses: actions/upload-artifact@v2 + - uses: actions/upload-artifact@v3 with: name: build-Android path: build/Android @@ -198,7 +199,7 @@ jobs: ANDROID_PACKAGE_NAME: ${{ secrets.ANDROID_PACKAGE_NAME }} steps: - name: Checkout Repository - uses: actions/checkout@v2 + uses: actions/checkout@v3 - name: Download Android Artifact uses: actions/download-artifact@v2 with: diff --git a/docs/05-gitlab/02-activation.mdx b/docs/05-gitlab/02-activation.mdx index d2508959..ce20c6c4 100644 --- a/docs/05-gitlab/02-activation.mdx +++ b/docs/05-gitlab/02-activation.mdx @@ -42,7 +42,7 @@ there should be a manual step that can be triggered for activation. All you need is [docker](https://www.docker.com/) installed on your machine. -1. Clone this project +1. Clone [this project](https://gitlab.com/game-ci/unity3d-gitlab-ci-example) 2. Pull the docker image and run bash inside, passing Unity username and password to env _hint: you should write this to a shell script and execute the shell script so you don't have @@ -115,7 +115,7 @@ All you need is [docker](https://www.docker.com/) installed on your machine. ## Unity Plus/Pro -1. Clone this project +1. Clone [this project](https://gitlab.com/game-ci/unity3d-gitlab-ci-example) 2. Pull the docker image and run bash inside, passing Unity username and password to env _hint: you should write this to a shell script and execute the shell script so you don't have diff --git a/docs/09-troubleshooting/common-issues.mdx b/docs/09-troubleshooting/common-issues.mdx index 4aec5d4e..fe3a1a0e 100644 --- a/docs/09-troubleshooting/common-issues.mdx +++ b/docs/09-troubleshooting/common-issues.mdx @@ -217,6 +217,25 @@ engine and CI/CD: - Try to search for error keywords in your message such as `error`, `failed`, `exception`, etc. - Read the error message closely to understand what's going on. +### No space left on device + +#### Error + +```plaintext +docker: failed to register layer: ApplyLayer exit status 1 stdout: stderr: write /opt/unity/Editor/Data/PlaybackEngines/AndroidPlayer/NDK/toolchains/llvm/prebuilt/linux-x86_64/lib64/clang/9.0.8/lib/linux/x86_64/libFuzzer.a: no space left on device. +``` + +#### Solution + +The GitHub-hosted runners often do not have enough disk space for game dev projects. To work around +this limitation, you could try to use the +[Free Disk Space (Ubuntu)](https://github.com/marketplace/actions/free-disk-space-ubuntu) action at +the start of your workflow. If you still require additional disk space for your project, you could +try using +[Self-hosted Runners](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners) +or using +[Cloud Runners](https://game.ci/docs/github-cloud-runner/game-ci-vs-cloud-runner#large-github-projects). + ## Still having problems? You can **search for existing issues**: