Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Restate CLI docs #249

Merged
merged 3 commits into from
Jan 11, 2024
Merged

Add Restate CLI docs #249

merged 3 commits into from
Jan 11, 2024

Conversation

gvdongen
Copy link
Contributor

@gvdongen gvdongen commented Jan 5, 2024

Fixes #248

  • CLI overview page
  • Describes installation
  • Describes configuration
  • Describes a few key commands

Copy link

cloudflare-workers-and-pages bot commented Jan 5, 2024

Deploying with  Cloudflare Pages  Cloudflare Pages

Latest commit: 7524e8a
Status:⚡️  Build in progress...

View logs

@gvdongen gvdongen mentioned this pull request Jan 5, 2024
Comment on lines +83 to +87
**Listing your services**

```shell
restate svc list
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A very useful/powerful command is also restate svc status which can take an optional argument (service name) if you want to filter out the output by a specific service.

It shows running the summary of the service and counters for invocations in various states. Is also shows the a sample of service keys that has active ongoing invocations.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cool, that is indeed a useful one! I added it.

- `RESTATE_HOST`: The hostname/IP address of the server. Default is `localhost`.
- `RESTATE_HOST_SCHEME`: Default is `http`.
- `RESTATE_META_URL`: To specify the full URL of meta service (scheme+host+port).
- `RESTATE_DATAFUSION_HTTP_URL`: To specify the full URL of datafusion HTTP endpoint.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm very hesitant about exposing this as a "data fusion" thing. I would like to combine this with the META URL under one name "admin" URL. Let me work on this first.


## Usage

Here are a few useful commands:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested: restate whoami is a good way to know if your CLI is configured correctly or not.

@AhmedSoliman
Copy link
Contributor

This is great and it would be very nice if we can add some screenshots of example outputs.

@gvdongen
Copy link
Contributor Author

This is great and it would be very nice if we can add some screenshots of example outputs.

I think it would be best to do this when the CLI and its printed output are a bit more stable since this will be intensive to maintain. Is that okay?

@gvdongen gvdongen merged commit 6543daa into main Jan 11, 2024
1 of 2 checks passed
@gvdongen gvdongen deleted the cli_docs branch January 11, 2024 08:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

CLI page with info on installation, configuration and a few key commands
2 participants