Triggering the rclone Build GitHub Action

The rclone Build GitHub Actions workflow automates the process of building platform-specific binaries for the Züs-integrated rclone client.

This guide explains how to manually trigger a build from the GitHub Actions UI.

1. Navigate to the Workflow

  • Go to the GitHub repository: https://github.com/0chain/rclone_zus. Click the Actions tab in the top menu.

  • In the left sidebar under "Workflows", select rclone Build.

  • The workflow summary page will load, showing the list of recent workflow runs.

2. Click “Run workflow”

  • On the upper right of the workflow summary page, click the Run workflow button.

  • A dropdown form will appear with two input fields defined via workflow_dispatch.

3. Fill in Inputs

You will need to enter the following inputs:

  • branch (required): Enter the Git reference for the build. Example: feat/rclone-build

  • build_type (required): Choose one of the following options:

    • all – builds binaries for all supported platforms

    • linux – builds the Linux binary

    • windows – builds the Windows binary

    • mac-amd – builds for macOS (Intel)

    • mac-arm – builds for macOS (Apple Silicon)

4. Start the Workflow

  • After filling in the form, click the green Run workflow button at the bottom.

  • The workflow will be triggered with the specified parameters.

  • Monitor the progress of each job in the Actions UI. Job logs and status are displayed in real-time.

Output Artifacts

Once the build completes, you can download the platform-specific binary from the respective job:

  • Expand the job (e.g. Build Linux Binary, Build Windows Binary)

  • Under Artifacts, download the resulting file (e.g. rclone-linux, rclone-windows, etc.)

Last updated