Synopsis

fcli tool env gitlab -f=<file> [--output-as=<outputAs>] [--excludes=<exclude>[, <exclude>…​]]…​ [--tools=<toolSelectors>[, <toolSelectors>…​]]…​ [[-h] [--env-prefix=<prefix>] [--log-file=<logFile>] [--log-level=<logLevel>] [--log-mask=<level>] [--debug]]

Description

Generates PATH and variable entries in KEY=VALUE format. Use --file to point to the GitLab-provided environment file. Use --output-as=shell|pwsh to instead emit echo redirect statements and direct environment assignments, suitable for use with source or Invoke-Expression.

Example usage (shell): source <(fcli tool env gitlab --file=$ENV_FILE --output-as=shell) Example usage (pwsh): fcli tool env gitlab --file=$env:ENV_FILE --output-as=pwsh | Out-String | Invoke-Expression

Options

--excludes=<exclude>[,<exclude>…​]

Comma-separated list of values to exclude from output. Allowed values: path, vars. Default: (none).

-f, --file=<file>

Path to the GitLab-provided environment file that should receive the generated entries.

--output-as=<outputAs>

Generate additional shell or PowerShell assignment statements alongside the CI-native output, so the script can update both the current task’s environment and subsequent tasks in a single pipe. Allowed values: shell, pwsh.

--tools=<toolSelectors>[,<toolSelectors>…​]

Comma-separated list of tool selectors in the form <tool-name>[:<version>]. Version selectors accept exact versions, aliases, partial semantic versions like '3' or '3.1', and '*' or 'all' to include every installed version. Defaults to the last installed version for each tool when omitted.

Generic fcli options (also see documentation link below)

--debug

Enable collection of debug logs.

--env-prefix=<prefix>

Prefix for resolving default option values. Default value: FCLI_DEFAULT.

-h, --help

Use 'fcli [command] -h' to display help for fcli (sub-)commands.

--log-file=<logFile>

Write log output to file. Default: ./fcli.log if logging is enabled.

--log-level=<logLevel>

Set logging level: TRACE, DEBUG, INFO, WARN, ERROR, NONE.

--log-mask=<level>

Log mask level: high, medium, low, none. Default: medium. Masking is done on a best-effort basis; no guarantee that all sensitive data will be masked.