Skip to content

Commit ee20c48

Browse files
committed
Docs: #3236
1 parent 643b263 commit ee20c48

File tree

5 files changed

+46
-19
lines changed

5 files changed

+46
-19
lines changed

Website/docs/application/aws-session-manager.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,20 @@ sidebar_position: 11
44

55
# AWS Session Manager
66

7+
:::danger
8+
9+
This feature has been removed! NETworkManager **2025.10.18.0** will be the last version to support the **AWS Session Manager** feature.
10+
11+
The [AWS Session Manager Plugin](https://github.com/aws/session-manager-plugin) is not actively maintained and contains several bugs (e.g. German / Spain keyboard layout issues). The current code base was also difficult to maintain and extend, and I currently have no test environment.
12+
13+
You can still use AWS Session Manager within NETworkManager with the [PowerShell](./powershell.md) feature by using the `aws ssm start-session --target <instance-id>` command.
14+
15+
:::
16+
717
With **AWS** (Systems Manager) **Session Manager**, you can connect to and manage an EC2 instance without opening inbound ports, running a bastion host, or managing SSH keys. The integration of AWS Session Manager with NETworkManger supports tabs and profiles for hosts. The connection can be established via a profile (double-click, Enter key or right-click `Connect`) or directly via the [connection](#connect) dialog. You can also synchronize your EC2 instances from AWS. To connect to the instances a PowerShell console is used with the AWS CLI and the AWS Session Manager plugin. The connection to the instances is established via the following command:
818

919
```PowerShell
10-
aws ssm start-session --target <INSTANCE_ID>
20+
aws ssm start-session --target <instance-id>
1121
```
1222

1323
:::note
@@ -281,7 +291,7 @@ Sensitive data like the API keys are stored in plain text in the file `~\.aws\cr
281291
You can verify the connection to the EC2 instance through AWS Systems Manager Session Manager by opening a PowerShell and connecting to the instance through AWS CLI:
282292

283293
```
284-
aws ssm start-session --target instance-id <INSTANCE_ID>
294+
aws ssm start-session --target instance-id <instance-id>
285295
```
286296

287297
## Connect

Website/docs/application/powershell.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ sidebar_position: 9
44

55
# PowerShell
66

7-
With **PowerShell** you can launch PowerShell consoles locally or connect to remote computers using [PowerShell Remoting](https://learn.microsoft.com/en-us/powershell/scripting/learn/ps101/08-powershell-remoting). You can also execute command-line applications such as `wsl`, `k9s`, or any other tools typically accessible from a PowerShell session. In addition, you can run PowerShell scripts directly within the console.
7+
With **PowerShell** you can launch PowerShell consoles locally or connect to remote computers using [PowerShell Remoting](https://learn.microsoft.com/en-us/powershell/scripting/learn/ps101/08-powershell-remoting). You can also execute command-line applications such as `wsl`, `aws ssm`, `k9s`, or any other tools typically accessible from a PowerShell session. In addition, you can run PowerShell scripts directly within the console.
88

99
The integration of PowerShell with NETworkManger supports tabs and profiles for hosts (and tools). You can launch the console / establish a connection via a profile (double-click, Enter key or right-click `Connect`) or directly via the [connection](#connect) dialog.
1010

@@ -22,12 +22,15 @@ Windows PowerShell and PowerShell are supported. Indructions for installing Powe
2222

2323
:::tip
2424

25-
Launching a command-line application such as `wsl` or `k9s` can be done by passing the [command](#command) to the PowerShell console.
25+
Launching a command-line application such as `wsl`, `aws ssm` or `k9s` can be done by passing the [command](#command) to the PowerShell console.
2626

2727
```powershell
2828
# Connect to WSL
2929
wsl -d <DISTRIBUTION>
3030
31+
# Connect to an EC2 instance via AWS Session Manager
32+
aws ssm start-session --target <instance-id>
33+
3134
# Connect to Kubernetes
3235
k9s --readonly
3336
```

Website/docs/changelog/next-release.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,15 @@ Release date: **xx.xx.2025**
2020
- Migrated from .NET 8.0 (LTS) to .NET 10.0 (LTS).
2121
Upgrade your [.NET Desktop Runtime to version 10.0 (LTS) - x64](https://dotnet.microsoft.com/en-us/download/dotnet/10.0/runtime) before you install this version. [#3229](https://github.com/BornToBeRoot/NETworkManager/pull/3229)
2222

23+
- `AWS Session Manager` feature has been removed. The [AWS Session Manager Plugin](https://github.com/aws/session-manager-plugin) is not actively maintained and contains several bugs (e.g. German / Spain keyboard layout issues). The current code base was also difficult to maintain and extend, and I currently have no test environment.
24+
The Sync feature (EC2 instances -> Profiles) has been removed as well, because it was limited to AWS Session Manager only. This will be re-introduced in a future release to support multiple proividers (`AWS`, `Azure`, etc.) and more features like `Ping Monitor`, `PuTTY` or `Remote Desktop`.
25+
26+
:::note
27+
28+
You can still use AWS Session Manager within NETworkManager with the PowerShell feature by using the `aws ssm start-session --target <instance-id>` command.
29+
30+
:::
31+
2332
## What's new?
2433

2534
**Remote Desktop**

Website/docs/faq/powershell-cmd-apps.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,18 @@ Create a new connection or profile with the following settings:
99
# Connect to WSL
1010
wsl -d <DISTRIBUTION>
1111
12+
# Connect to an EC2 instance via AWS Session Manager
13+
aws ssm start-session --target <instance-id>
14+
1215
# Connect to Kubernetes
1316
k9s --readonly
1417
```
1518

1619
:::note
1720

18-
Windows Subsystem for Linux (WSL) must be installed and enabled on your system to use this feature.
21+
Windows Subsystem for Linux (WSL) must be installed and enabled on your system to use WSL.
22+
23+
AWS CLI and AWS Session Manager Plugin must be installed and configured to connect to EC2 instances.
1924

2025
:::
2126

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
1-
# Setting priority
1+
# Settings Priority
22

3-
## In which priority are settings applied?
3+
## How does NETworkManager prioritize settings across different levels (global, group, profile)?
44

5-
There are three levels of settings:
5+
NETworkManager uses a clear hierarchy to apply settings, allowing you to configure profiles with flexibility and precision. Settings are prioritized across three levels, from broadest to most specific:
66

7-
- **Global settings**
7+
1. **Global Settings**
8+
Default settings applied across all profiles in NETworkManager unless overridden.
9+
_Example_: A default SSH key file used for all network devices.
810

9-
Global settings are the default settings of the application. They are used if no other settings are available.
11+
2. **Group Settings**
12+
Applied to all profiles within a specific group, overriding global settings. Use these to customize settings for a set of devices.
13+
_Example_: A unique SSH key file for a group of servers in a data center.
1014

11-
- **Group settings**
15+
3. **Profile Settings**
16+
Specific to an individual profile, overriding both group and global settings. Use these for fine-tuned configurations on a single device.
17+
_Example_: A custom SSH key file for a critical server.
1218

13-
Group settings are applied to all profiles in a group. They overwrite global settings. E.g. for a specific group of servers to overwrite the SSH key file or Windows credentials.
19+
Settings are applied in this order:
1420

15-
- **Profile settings**
16-
17-
Profile settings are applied to a specific profile. They overwrite group settings. E.g. for a specific server to overwrite the SSH key file or Windows credentials.
18-
19-
The priority is as follows:
20-
21-
`Global settings (default) → Group settings (overwrites global) → Profile settings (overwrites group)`
21+
**Global Settings (default) → Group Settings (overrides Global) → Profile Settings (overrides Group)**

0 commit comments

Comments
 (0)