install-juliaup

This is a GitHub Action that installs the Julia programming language (using Juliaup, a Julia installer and version manager) for use in your CI jobs.

When you use this action, it will do three things:

1. Make sure that juliaup is available (downloading it if necessary).
2. Use juliaup to install the specified version of Julia.
3. Add both juliaup and julia to the PATH.

Usage

Examples

To install the latest stable Julia v1:

- uses: julia-actions/install-juliaup@v3
  with:
    channel: '1'

# Your selected Julia version is now available in the PATH:
- run: julia --version

Note: this uses the default GITHUB_TOKEN to authenticate read-only calls to the GitHub API. To use a different token, provide it in the optional token input:

- uses: julia-actions/install-juliaup@v3
  with:
    channel: '1'
    token: ${{ secrets.MY_GITHUB_TOKEN }}

To install a specific Julia version:

- uses: julia-actions/install-juliaup@v3
  with:
    channel: '1.10.2'

In general, if juliaup add FOO would have been a valid command on your local machine, then FOO is a valid value for the channel input to this action.

So, for example, suppose that you want alpha pre-releases for the next upcoming release. On your local machine, juliaup add alpha is a valid command. Therefore, alpha is a valid value for the channel input to this action:

- uses: julia-actions/install-juliaup@v3
  with:
    channel: 'alpha'

See the Juliaup README for more examples.

Job matrices

For example, suppose that your GitHub Actions workflow file includes a job matrix as such:

strategy:
  matrix:
    juliaup_channel:
      - 'lts'
      - '1.10'
      - '1'
      - 'nightly'

Then install-juliaup can use this job matrix as follows:

- uses: julia-actions/install-juliaup@v3
  with:
    channel: ${{ matrix.juliaup_channel }}

Calling juliaup directly

When the install-juliaup action runs, it adds juliaup to the PATH. Therefore, in subsequent steps, you can directly run juliaup commands if you want:

- uses: julia-actions/install-juliaup@v3
  with:
    channel: '1'

- run: juliaup status
- run: juliaup add 1.10
- run: juliaup update 1.10
- run: juliaup default 1.10
- run: juliaup status

Keeping your GitHub Actions up to date

We highly recommend that you set up a tool to keep your GitHub Actions up to date.

One such tool is Dependabot, although you could use a different tool if you want.

To set up Dependabot version updates, create a file named .github/dependabot.yml in your repo with the following contents:

version: 2
updates:
  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "monthly"
    open-pull-requests-limit: 99
    labels:
      - "dependencies"
      - "github-actions"

For more details on Dependabot version updates, see the GitHub Dependabot documentation.

Contributing to this repo

Please see the README in the devdocs folder.

Installing a specific Juliaup version

By default, the latest v1 version of Juliaup will be installed. If you instead want to install a specific version of Juliaup, you can specify it in the optional juliaup-version input. For example:

- uses: julia-actions/install-juliaup@v3
  with:
    channel: '1'
    juliaup-version: '1.19.4'