zrok/docs/quickstart.md

# zrok quickstart

## ziti quickstart

```
$ source /dev/stdin <<< "$(wget -qO- https://raw.githubusercontent.com/openziti/ziti/release-next/quickstart/docker/image/ziti-cli-functions.sh)"; expressInstall
```

## configure frontend identity

```
$ ziti edge create identity service frontend -o ~/.zrok/identities/frontend.jwt
New identity proxy created with id: -zbBF8eVb-
Enrollment expires at 2022-08-10T18:46:16.641Z
```

```
$ ziti edge enroll -j ~/.zrok/identities/frontend.jwt -o ~/.zrok/identities/frontend.json
INFO    generating 4096 bit RSA key                  
INFO    enrolled successfully. identity file written to: proxy.json
```

```
$ ziti edge create erp frontend --edge-router-roles "#all" --identity-roles "@frontend"
New edge router policy frontend created with id: aOxvtWIanFIAwuU51lF9SU
```

## configure controller identity
```
$ ziti edge create identity service ctrl -o ~/.zrok/identities/ctrl.jwt 
New identity ctrl created with id: e8c3tQo3SR
Enrollment expires at 2022-10-14T19:59:01.908Z
```

```
$ ziti edge enroll -j ~/.zrok/identities/ctrl.jwt -o ~/.zrok/identities/ctrl.json
INFO    generating 4096 bit RSA key                  
INFO    enrolled successfully. identity file written to: /home/michael/.zrok/identities/ctrl.json 
```

```
$ ziti edge create erp ctrl --edge-router-roles "#all" --identity-roles "@ctrl"
New edge router policy ctrl created with id: 7OxvtWIanFIAwuU51lF9SU
```

## create metrics service
```
$ ziti edge create service metrics
New service metrics created with id: 56y5AFsKmSsIWLsmFNBeJz
```

### allow the controller to bind the metrics service
```
$ ziti edge create sp ctrl-bind Bind --identity-roles "@ctrl" --service-roles "@metrics"
New service policy ctrl-bind created with id: 3SXgFftSgBnenjgdBENOGR
```

### allow frontends to dial the metrics service
```
$ ziti edge create sp ctrl-dial Dial --identity-roles "@frontend" --service-roles "@metrics"
New service policy ctrl-dial created with id: 6pCe9uGj8oB2JXlWb44x2u
```

## start zrok resources

adjust `ctrl.yml` (or create a copy for your environment).

```
$ zrok ctrl etc/ctrl.yml
```

```
$ zrok proxy ~/.zrok/proxy.json
```

## create zrok account

```
$ zrok create account 
New Username: michael@quigley.com
New Password: 
Confirm Password: 
[   3.122]    INFO main.glob..func1: api token: 9ae56d39a6e96d65a45518b5ea1637a0677581a33ba44bbc3c103f6351ec478fb8185e97a993382ed2daa26720d40b052824dbce5ef38874c82893f33e445b06
```

## enable zrok for your shell

```
$ zrok enable 9ae56d39a6e96d65a45518b5ea1637a0677581a33ba44bbc3c103f6351ec478fb8185e97a993382ed2daa26720d40b052824dbce5ef38874c82893f33e445b06
[   0.691]    INFO main.enable: enabled, identity = 'ARjEc8eVA-'
```

## tunnel

```
$ zrok http <endpoint>
```