Command-Line
Install and configure the hoop.dev CLI to interact with your applications.
Prerequisites
To get the most out of this guide, you will need to:
Installation
Through homebrew:
To upgrade it:
Authenticate
The <gateway-url>
is the URL of the API Gateway. If you are using our managed instance, you don’t need to set this value, go directly to the hoop login
command below that it will isntruct it for you with the correct URL as https://use.hoop.dev
. If you deployed your own instance, this will be the same URL you set on the API_URL
environment variable for the host of your hoop Gateway.
With this configuration in place, you must obtain an access token to interact with the API. The command below will open your browser and redirect you to the identity provider.
If you need to clear this configuration, issue the command below.
hoop connect
The hoop connect
command allows you to create an interactive session with a remote resource. The resource can be an interactive terminal console or TCP services such as databases.. Here are a few examples:
Terminal console
- docker exec
- bash
- ssh
- rails console
- python console
- kubectl exec
- aws ecs execute-command
TCP
The connect feature can be used to interact with TCP services such as databases. It can be used with an IDE or any native database client. The port is forwarded locally to the end-user, providing a secure connection to remote services.
The connection is established through a secure tunnel. The connection is encrypted and authenticated using the user’s identity.