@nocoo/eagle-agent 0.5.0 → 0.5.1
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 +14 -4
- package/dist/package.json +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,16 +6,16 @@ Read-only Herdr inventory, task evidence, machine resources and named TCP port c
|
|
|
6
6
|
|
|
7
7
|
Check `node --version`, `npm --version` and `herdr --version` first. Install Node.js 24+ from https://nodejs.org/en/download if needed, and have Herdr installed and running. No Eagle repository checkout, TypeScript compiler or npm login is required to install this public package.
|
|
8
8
|
|
|
9
|
-
Install Agent v0.5.
|
|
9
|
+
Install Agent v0.5.1 from npm. The Agent and Eagle website share the same release version:
|
|
10
10
|
|
|
11
11
|
```sh
|
|
12
|
-
npm install -g @nocoo/eagle-agent@0.5.
|
|
12
|
+
npm install -g @nocoo/eagle-agent@0.5.1 --registry=https://registry.npmjs.org
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
**If npm downloads time out, use the Tencent Cloud mirror / 下载超时时首选腾讯云镜像：**
|
|
16
16
|
|
|
17
17
|
```sh
|
|
18
|
-
npm install -g @nocoo/eagle-agent@0.5.
|
|
18
|
+
npm install -g @nocoo/eagle-agent@0.5.1 --registry=https://mirrors.cloud.tencent.com/npm/
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
`--registry` applies only to this installation; it does not change your global npm configuration. Mirrors may lag (`404` / `ETARGET`); retry later or use the official registry when reachable. Keep the pinned version, HTTPS and certificate verification. Eagle credentials are unrelated to npm and must never be sent to a registry.
|
|
@@ -23,7 +23,7 @@ npm install -g @nocoo/eagle-agent@0.5.0 --registry=https://mirrors.cloud.tencent
|
|
|
23
23
|
Verify the installation before configuring the agent:
|
|
24
24
|
|
|
25
25
|
```sh
|
|
26
|
-
eagle-agent --version # expected: 0.5.
|
|
26
|
+
eagle-agent --version # expected: 0.5.1
|
|
27
27
|
eagle-agent --help
|
|
28
28
|
```
|
|
29
29
|
|
|
@@ -51,6 +51,16 @@ Optional `watchPorts`: `[{ "name": "Raven", "port": 7024 }]`. Only loopback TCP
|
|
|
51
51
|
|
|
52
52
|
Detailed configuration and manager evidence format: https://github.com/nocoo/eagle/blob/main/docs/AGENT.md
|
|
53
53
|
|
|
54
|
+
## Optional reporting proxy
|
|
55
|
+
|
|
56
|
+
Direct connections are the default. Set `NODE_USE_ENV_PROXY=0` in the service environment and leave proxy addresses unset. A local proxy is not a prerequisite for Eagle.
|
|
57
|
+
|
|
58
|
+
Only when the machine needs a proxy, set `NODE_USE_ENV_PROXY=1` and `HTTPS_PROXY` to the user's verified HTTP(S) proxy URL. Use `HTTP_PROXY` for HTTP destinations and `NO_PROXY` for destinations that should bypass the proxy. Do not assume a host or port. These are Node environment settings, not fields in `agent.json`; no new Agent package is required. Node.js 24.5+ is required for proxying the `realtime-watch` WebSocket connection.
|
|
59
|
+
|
|
60
|
+
Apply the selected environment to each Eagle service (`watch`, `manager-watch`, and `realtime-watch`) and to any foreground verification command. On macOS, use the LaunchAgent's `EnvironmentVariables`; on Linux, use the user systemd unit's environment. Keep proxy credentials, if needed, in protected service configuration, never in command arguments or reports.
|
|
61
|
+
|
|
62
|
+
To return to direct connections, remove the service's proxy address variables and set `NODE_USE_ENV_PROXY=0`. Reload the service definition and restart it; restarting alone does not reload a changed launchd plist. Wait until the old service has fully stopped before registering it again. Preserve the secure Agent config, spool and Manager state. Confirm a fresh successful report and an empty pending spool; a running process alone does not prove connectivity. An explicitly selected proxy remains required until disabled; there is no automatic direct fallback.
|
|
63
|
+
|
|
54
64
|
## Continuous Pane summaries
|
|
55
65
|
|
|
56
66
|
Eagle is agent-neutral. Reuse the machine's existing management Agent; **Hermes Agent is recommended, not required**. Cherry is one machine's local Hermes profile/alias, not a product or dependency to install. Do not search for or install an unrelated Cherry package. If no suitable Agent is configured yet, keep `eagle-agent watch` running and report that semantic setup is pending.
|
package/dist/package.json
CHANGED