Token issue command
Issue a token file redeemable for a link to the current site.
This command first creates an access grant in order to issue the token.
Issuing a token requires a site with link access enabled. The command waits for the site to enter the ready state before producing the token.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|---|
| Waits for | Ready |
Usage
skupper token issue <file> [options]
Examples
# Issue an access token
$ skupper token issue ~/token.yaml
Waiting for status...
Access grant "west-6bfn6" is ready.
Token file /home/fritz/token.yaml created.
Transfer this file to a remote site. At the remote site,
create a link to this site using the 'skupper token
redeem' command:
$ skupper token redeem <file>
The token expires after 1 use or after 15 minutes.
# Issue an access token with non-default limits
$ skupper token issue ~/token.yaml --expiration-window 24h --redemptions-allowed 3
# Issue a token using an existing access grant
$ skupper token issue ~/token.yaml --grant west-1
Primary options
<file>
The name of the token file to create.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|
--timeout
Raise an error if the operation does not complete in the given period of time.
| Default |
|
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
--expiration-window
The period of time in which an access token for this grant can be redeemed.
| Default |
|
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
--redemptions-allowed
The number of times an access token for this grant can be redeemed.
| Default | 1 |
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
--grant
Use the named access grant instead of creating a new one.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|
Global options
--context
Set the kubeconfig context.
| Platforms | Kubernetes |
|---|---|
| See also | Kubernetes kubeconfigs |
--kubeconfig
Set the path to the kubeconfig file.
| Platforms | Kubernetes |
|---|---|
| See also | Kubernetes kubeconfigs |
--namespace
Set the namespace.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|---|
| See also | Kubernetes namespaces |
--platform
Set the Skupper platform.
| Default |
| ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Choices |
| ||||||||
| Platforms | Kubernetes, Docker, Podman, Linux | ||||||||
| See also | Platform concept |
--help
Display help and exit.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|
Errors
Link access is not enabled
Link access at this site is not currently enabled. You can use "skupper site update --enable-link-access" to enable it.