@fluid-app/fluid-cli-mist 0.1.36 → 0.1.38
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -8
- package/dist/index.d.mts +12 -0
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +2171 -1972
- package/dist/index.mjs.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -6,14 +6,14 @@ Each command takes an optional mist slug. Without one, it reads the `.mist` file
|
|
|
6
6
|
|
|
7
7
|
## Commands
|
|
8
8
|
|
|
9
|
-
| Command | Purpose
|
|
10
|
-
| ------------------------------------------------------- |
|
|
11
|
-
| `list`, `show`, `create`, `update`, `delete`, `restore` | Manage mists
|
|
12
|
-
| `clone`, `push`, `pull`, `open` | Work with the code and the deployed app
|
|
13
|
-
| `attach`, `attach-droplet` | Wire a surface (such as a Droplet) to a mist
|
|
14
|
-
| `deployments`, `logs` | See builds and runtime output
|
|
15
|
-
| `env list\|set\|unset\|pull` | Manage production env vars
|
|
16
|
-
| `droplet repair\|reinstall`
|
|
9
|
+
| Command | Purpose |
|
|
10
|
+
| ------------------------------------------------------- | ------------------------------------------------------------ |
|
|
11
|
+
| `list`, `show`, `create`, `update`, `delete`, `restore` | Manage mists |
|
|
12
|
+
| `clone`, `push`, `pull`, `open` | Work with the code and the deployed app |
|
|
13
|
+
| `attach`, `attach-droplet` | Wire a surface (such as a Droplet) to a mist |
|
|
14
|
+
| `deployments`, `logs` | See builds and runtime output |
|
|
15
|
+
| `env list\|set\|unset\|pull` | Manage production env vars |
|
|
16
|
+
| `droplet repair\|reinstall\|egress-proxy` | Repair, reinstall or ask for egress for the attached Droplet |
|
|
17
17
|
|
|
18
18
|
## Generating a secret
|
|
19
19
|
|
|
@@ -24,6 +24,19 @@ fluid mist env set my-mist SESSION_SECRET --generate --bytes 64
|
|
|
24
24
|
|
|
25
25
|
`--generate` mints a cryptographically strong base64url secret (16 to 128 bytes, default 32), writes it to the key, and prints it once. Fluid stores env values encrypted and `env list` never shows them, so copy the secret immediately if you also need it in `.env.local`. It uses the same generator as Mist's `set_mist_env_var` tool. It refuses Mist-managed keys before generating anything. Redeploy with `fluid mist push` for the change to take effect.
|
|
26
26
|
|
|
27
|
+
## Reaching Exigo through the egress proxy
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
fluid mist create --droplet --egress-proxy # new mist + droplet, asking for egress
|
|
31
|
+
fluid mist attach-droplet --egress-proxy # attach (or reuse) a droplet, asking for egress
|
|
32
|
+
fluid mist droplet egress-proxy on # ask for egress for the attached Droplet
|
|
33
|
+
fluid mist droplet egress-proxy off # withdraw the request (and any grant)
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Fluid's egress proxy lets a Droplet's installations reach external systems such as Exigo from Fluid's fixed outbound IPs. Because those IPs reach every Exigo tenant, the grant is Fluid's decision: these commands set the Droplet's `egress_proxy_requested`, and a Fluid admin approves it, which sets `egress_proxy_enabled`. The output says whether the request is waiting or already granted. Withdrawing the request also withdraws the grant.
|
|
37
|
+
|
|
38
|
+
`--egress-proxy` works on `create --droplet`, `create --kind droplet`, `create --hostable`, `attach --kind droplet` and `attach-droplet`. On a Droplet that already exists it updates the request rather than ignoring the flag. Fluid accepts an egress request only from a company admin. For anyone else it refuses the request: `--egress-proxy` then sets the droplet up without it and warns, and `droplet egress-proxy` fails without writing, because Fluid does not show the egress fields to them either. A Fluid that predates the fields ignores them, and the commands warn or fail the same way. `droplet egress-proxy off` also clears a grant a Fluid admin gave without a request. Mist Desktop's Safe Mode treats `droplet egress-proxy` as a write.
|
|
39
|
+
|
|
27
40
|
## Repairing the attached Droplet
|
|
28
41
|
|
|
29
42
|
```bash
|
package/dist/index.d.mts
CHANGED
|
@@ -114,12 +114,19 @@ interface DropletCreateInput {
|
|
|
114
114
|
install_webhook_url?: string;
|
|
115
115
|
uninstall_webhook_url?: string;
|
|
116
116
|
requested_scopes?: string[];
|
|
117
|
+
/** Ask Fluid to let the droplet's installations reach external systems
|
|
118
|
+
* (e.g. Exigo) through Fluid's egress proxy. A Fluid root admin grants
|
|
119
|
+
* it. Omitted means not asked. */
|
|
120
|
+
egress_proxy_requested?: boolean;
|
|
117
121
|
settings?: Record<string, unknown>;
|
|
118
122
|
}
|
|
119
123
|
interface DropletUpdateInput {
|
|
120
124
|
embed_url?: string;
|
|
121
125
|
install_webhook_url?: string;
|
|
122
126
|
uninstall_webhook_url?: string;
|
|
127
|
+
/** Ask for (true) or withdraw (false) egress through the proxy. Only a
|
|
128
|
+
* Fluid root admin sets the grant itself. */
|
|
129
|
+
egress_proxy_requested?: boolean;
|
|
123
130
|
}
|
|
124
131
|
interface DropletCreateRequest {
|
|
125
132
|
droplet: DropletCreateInput;
|
|
@@ -140,6 +147,11 @@ interface DropletRecord {
|
|
|
140
147
|
embed_url?: string | null;
|
|
141
148
|
install_webhook_url?: string | null;
|
|
142
149
|
uninstall_webhook_url?: string | null;
|
|
150
|
+
/** The owner's egress request and the Fluid root-admin grant. Both are
|
|
151
|
+
* absent when the caller is not a company admin, and from APIs that
|
|
152
|
+
* predate them. */
|
|
153
|
+
egress_proxy_requested?: boolean;
|
|
154
|
+
egress_proxy_enabled?: boolean;
|
|
143
155
|
}
|
|
144
156
|
interface DropletCreateResponse {
|
|
145
157
|
droplet: DropletRecord;
|
package/dist/index.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/index.ts"],"mappings":";;;;;;AASA;;;;;KAAY,QAAA;AAAA,KAEA,SAAA;;;;AAeZ;;;;KAAY,YAAA;AAAA,UAEK,OAAA;EACf,EAAA;EACA,IAAA;EACA,IAAA;AAAA;;;;;AAWF;;;;cAAa,wBAAA;AAAA,KAMD,oBAAA,WAA+B,wBAAA;AAAA,UAE1B,IAAA;EACf,EAAA;EACA,IAAA;EAJyC;AAE3C;EAKE,IAAA;EACA,KAAA,EAAO,SAAA;EACP,IAAA,EAAM,QAAA;;;;;;EAMN,aAAA,GAAgB,YAAA;;EAEhB,WAAA;;;;;;EAMA,WAAA;EACA,UAAA;;EAEA,oBAAA;EACA,OAAA,EAAS,OAAA;EACT,cAAA;EACA,UAAA;EACA,UAAA;AAAA;AAAA,UAGe,gBAAA;EACf,MAAA;EACA,KAAA;EACA,WAAA;EACA,WAAA;AAAA;AAAA,UAGe,OAAA;EACf,UAAA;EACA,SAAA;EACA,UAAA,GAAa,gBAAA;AAAA;AAAA,UAGE,aAAA;EACf,IAAA,EAAM,OAAA;EACN,MAAA;AAAA;AAAA,KAGU,gBAAA;EACV,KAAA,EAAO,IAAA;EACP,IAAA,EAAM,OAAA;EACN,MAAA;AAAA;AAAA,KAGU,gBAAA;EACV,IAAA,EAAM,IAAA;EACN,IAAA,EAAM,OAAA;EACN,MAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;IACE,IAAA;IACA,IAAA,GAAO,QAAA;EAAA;AAAA;AAfX;;;;;AAAA,UAwBiB,iBAAA;EACf,IAAA;IACE,IAAA;IACA,IAAA,GAAO,QAAA;EAAA;AAAA;AAAA,UAQM,kBAAA;EACf,IAAA;;;EAGA,SAAA;EACA,mBAAA;EACA,qBAAA;EACA,gBAAA;EACA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,kBAAA;EACf,SAAA;EACA,mBAAA;EACA,qBAAA;AAAA;AAAA,UAGe,oBAAA;EACf,OAAA,EAAS,kBAAA;AAAA;AAAA,UAGM,oBAAA;EACf,OAAA,EAAS,kBAAA;AAAA;AAAA,UAGM,aAAA
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/index.ts"],"mappings":"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"}
|