[UTILS] FSGET: Add source/build-dep/showsrc actions, make token optional (if already configured), add swapi_ token support (#3217)

- New optional actions: `source`, `build-dep`, `showsrc`. `source` and `build-dep` resolve the source version for the current dpkg architecture, so apt does not pick a package built for another arch.
  - TOKEN can be omitted when the apt repository is already configured.
  - `swapi_*` tokens are accepted as FreeSWITCH Enterprise tokens, same as `PT*`
  - Arguments can be given in any order.

  Examples:
```
    curl -sSL https://freeswitch.org/fsget | bash -s pat_xxxxx release install
    curl -sSL https://freeswitch.org/fsget | bash -s swapi_xxxxx prerelease build-dep
    curl -sSL https://freeswitch.org/fsget | bash -s build-dep release pat_xxxxx
    curl -sSL https://freeswitch.org/fsget | bash -s source
    curl -sSL https://freeswitch.org/fsget | bash -s showsrc
```
This commit is contained in:
Andrey Volk authored and GitHub committed 2026-10-09 16:18:38 +03:00
1 parent 3dee68e810
commit f4778e7f2c
2 files changed
+215 -35

No files matched your search

+49 -3
View File
@@ -19,17 +19,63 @@ A `SignalWire Personal Access Token` (PAT) or an `API Token` (for enterprise cus
## Configuring FreeSWITCH Debian repository
```
curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token> [release|prerelease] [install]
curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token> [release|prerelease] [install|source|build-dep|showsrc]
```
Notice that `fsget` accepts arguments:
- `<PAT or FSA token>` (Required)
- `<PAT or FSA token>` (Optional) - omit if the FreeSWITCH apt repository is already configured (the credentials are already in `/etc/apt/auth.conf`)
- `[release|prerelease]` (Optional) - `release` by default, `prerelease` is what you see in the `master` branch
- `[install]` (Optional) - If missing it will not install FreeSWITCH automatically after configuring the repository
- `[install|source|build-dep|showsrc]` (Optional) - action to perform after the repository is configured. If missing it will not perform any action after configuring the repository.
`FreeSWITCH Community` or `FreeSWITCH Enterprise` version is installed based on the token provided.
Enterprise customers may install `FreeSWITCH Community` versions by using a `SignalWire Personal Access Token` instead of an `API Token`.
Arguments can be supplied in any order — `fsget` recognises them by pattern. These commands are equivalent:
```
curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token> release build-dep
curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token> build-dep release
curl -sSL https://freeswitch.org/fsget | bash -s build-dep release <PAT or API token>
```
### Available actions
| Action | Description |
| --- | --- |
| `install` | Install `freeswitch-meta-all` after the repository is configured. |
| `source` | Download the FreeSWITCH source package for the current build architecture. |
| `build-dep` | Install the FreeSWITCH build dependencies for the current build architecture. |
| `showsrc` | Print the FreeSWITCH source version for the current build architecture and exit. |
Because FreeSWITCH source packages encode the build architecture in the version string, `source` and `build-dep` look up the exact version for the current architecture before invoking `apt-get` — this prevents `apt` from picking a candidate built for a different architecture.
### Examples
Configure the repository and install FreeSWITCH:
```
curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token> release install
```
Configure the prerelease repository and install build dependencies:
```
curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token> prerelease build-dep
```
Token already configured — just install build dependencies for the current architecture:
```
curl -sSL https://freeswitch.org/fsget | bash -s build-dep
```
Token already configured — fetch the source package for the current architecture:
```
curl -sSL https://freeswitch.org/fsget | bash -s source
```
Print the FreeSWITCH source version for the current architecture:
```
curl -sSL https://freeswitch.org/fsget | bash -s showsrc
```
## Installing FreeSWITCH
If not installed already type