You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: README.md
+37-18
Original file line number
Diff line number
Diff line change
@@ -23,9 +23,10 @@ GitHub Action to set up the [pixi](https://github.com/prefix-dev/pixi) package m
23
23
## Usage
24
24
25
25
```yml
26
-
- uses: prefix-dev/setup-pixi@v0.8.2
26
+
- uses: prefix-dev/setup-pixi@v0.8.3
27
27
with:
28
-
pixi-version: v0.41.1
28
+
pixi-version: v0.41.4
29
+
29
30
cache: true
30
31
auth-host: prefix.dev
31
32
auth-token: ${{ secrets.PREFIX_DEV_TOKEN }}
@@ -34,7 +35,7 @@ GitHub Action to set up the [pixi](https://github.com/prefix-dev/pixi) package m
34
35
35
36
> [!WARNING]
36
37
> Since pixi is not yet stable, the API of this action may change between minor versions.
37
-
> Please pin the versions of this action to a specific version (i.e., `prefix-dev/setup-pixi@v0.8.2`) to avoid breaking changes.
38
+
> Please pin the versions of this action to a specific version (i.e., `prefix-dev/setup-pixi@v0.8.3`) to avoid breaking changes.
38
39
> You can automatically update the version of this action by using [Dependabot](https://docs.github.com/en/code-security/dependabot/working-with-dependabot/keeping-your-actions-up-to-date-with-dependabot).
39
40
>
40
41
> Put the following in your `.github/dependabot.yml` file to enable Dependabot for your GitHub Actions:
@@ -73,7 +74,7 @@ In order to not exceed the [10 GB cache size limit](https://docs.github.com/en/a
73
74
This can be done by setting the `cache-write` argument.
The following example will install both the `py311` and the `py312` environment on the runner.
129
130
130
131
```yml
131
-
- uses: prefix-dev/setup-pixi@v0.8.2
132
+
- uses: prefix-dev/setup-pixi@v0.8.3
132
133
with:
133
134
# separated by spaces
134
135
environments: >-
@@ -149,6 +150,7 @@ There are currently three ways to authenticate with pixi:
149
150
- using a token
150
151
- using a username and password
151
152
- using a conda-token
153
+
- using an S3 key pair
152
154
153
155
For more information, see the [pixi documentation](https://prefix.dev/docs/pixi/authentication).
154
156
@@ -163,7 +165,7 @@ Specify the token using the `auth-token` input argument.
163
165
This form of authentication (bearer token in the request headers) is mainly used at [prefix.dev](https://prefix.dev).
164
166
165
167
```yml
166
-
- uses: prefix-dev/setup-pixi@v0.8.2
168
+
- uses: prefix-dev/setup-pixi@v0.8.3
167
169
with:
168
170
auth-host: prefix.dev
169
171
auth-token: ${{ secrets.PREFIX_DEV_TOKEN }}
@@ -175,7 +177,7 @@ Specify the username and password using the `auth-username` and `auth-password`
175
177
This form of authentication (HTTP Basic Auth) is used in some enterprise environments with [artifactory](https://jfrog.com/artifactory) for example.
176
178
177
179
```yml
178
-
- uses: prefix-dev/setup-pixi@v0.8.2
180
+
- uses: prefix-dev/setup-pixi@v0.8.3
179
181
with:
180
182
auth-host: custom-artifactory.com
181
183
auth-username: ${{ secrets.PIXI_USERNAME }}
@@ -184,16 +186,33 @@ This form of authentication (HTTP Basic Auth) is used in some enterprise environ
184
186
185
187
#### Conda-token
186
188
187
-
Specify the conda-token using the `conda-token` input argument.
189
+
Specify the conda-token using the `auth-conda-token` input argument.
188
190
This form of authentication (token is encoded in URL: `https://my-quetz-instance.com/t/<token>/get/custom-channel`) is used at [anaconda.org](https://anaconda.org) or with [quetz instances](https://github.com/mamba-org/quetz).
189
191
190
192
```yml
191
-
- uses: prefix-dev/setup-pixi@v0.8.2
193
+
- uses: prefix-dev/setup-pixi@v0.8.3
192
194
with:
193
195
auth-host: anaconda.org # or my-quetz-instance.com
194
-
conda-token: ${{ secrets.CONDA_TOKEN }}
196
+
auth-conda-token: ${{ secrets.CONDA_TOKEN }}
195
197
```
196
198
199
+
#### S3
200
+
201
+
Specify the S3 key pair using the `auth-access-key-id` and `auth-secret-access-key` input arguments.
202
+
You can also specify the session token using the `auth-session-token` input argument.
See the [pixi documentation](https://pixi.sh/latest/advanced/s3) for more information about S3 authentication.
215
+
197
216
### Custom shell wrapper
198
217
199
218
`setup-pixi` allows you to run command inside of the pixi environment by specifying a custom shell wrapper with `shell: pixi run bash -e {0}`.
@@ -255,15 +274,15 @@ To this end, `setup-pixi` adds all environment variables set when executing `pix
255
274
As a result, all installed binaries can be accessed without having to call `pixi run`.
256
275
257
276
```yml
258
-
- uses: prefix-dev/setup-pixi@v0.8.2
277
+
- uses: prefix-dev/setup-pixi@v0.8.3
259
278
with:
260
279
activate-environment: true
261
280
```
262
281
263
282
If you are installing multiple environments, you will need to specify the name of the environment that you want to be activated.
264
283
265
284
```yml
266
-
- uses: prefix-dev/setup-pixi@v0.8.2
285
+
- uses: prefix-dev/setup-pixi@v0.8.3
267
286
with:
268
287
environments: >-
269
288
py311
@@ -280,7 +299,7 @@ You can specify whether `setup-pixi` should run `pixi install --frozen` or `pixi
280
299
See the [official documentation](https://prefix.dev/docs/pixi/cli#install) for more information about the `--frozen` and `--locked` flags.
281
300
282
301
```yml
283
-
- uses: prefix-dev/setup-pixi@v0.8.2
302
+
- uses: prefix-dev/setup-pixi@v0.8.3
284
303
with:
285
304
locked: true
286
305
# or
@@ -299,7 +318,7 @@ The first one is the debug logging of the action itself.
299
318
This can be enabled by running the action with the `RUNNER_DEBUG` environment variable set to `true`.
300
319
301
320
```yml
302
-
- uses: prefix-dev/setup-pixi@v0.8.2
321
+
- uses: prefix-dev/setup-pixi@v0.8.3
303
322
env:
304
323
RUNNER_DEBUG: true
305
324
```
@@ -317,7 +336,7 @@ The second type is the debug logging of the pixi executable.
317
336
This can be specified by setting the `log-level` input.
318
337
319
338
```yml
320
-
- uses: prefix-dev/setup-pixi@v0.8.2
339
+
- uses: prefix-dev/setup-pixi@v0.8.3
321
340
with:
322
341
# one of `q`, `default`, `v`, `vv`, or `vvv`.
323
342
log-level: vvv
@@ -343,7 +362,7 @@ If nothing is specified, `post-cleanup` will default to `true`.
343
362
On self-hosted runners, you also might want to alter the default pixi install location to a temporary location. You can use `pixi-bin-path: ${{ runner.temp }}/bin/pixi` to do this.
344
363
345
364
```yml
346
-
- uses: prefix-dev/setup-pixi@v0.8.2
365
+
- uses: prefix-dev/setup-pixi@v0.8.3
347
366
with:
348
367
post-cleanup: true
349
368
# ${{ runner.temp }}\Scripts\pixi.exe on Windows
@@ -359,7 +378,7 @@ You can also use a preinstalled local version of pixi on the runner by not setti
359
378
This can be overwritten by setting the `manifest-path` input argument.
0 commit comments