Skip to content

Commit 7a943a2

Browse files
committed
Add Readme.md
1 parent 046b369 commit 7a943a2

1 file changed

Lines changed: 56 additions & 0 deletions

File tree

ssh-container/README.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# SSH Container for Rabbit User Container Workflows
2+
3+
This container provides SSH access to launcher containers running on Rabbit nodes.
4+
5+
## Overview
6+
7+
The SSH container enables remote access to Rabbit User Container workflows. It requires predetermined UID/GID and generated SSH keys baked into the image for secure authentication.
8+
9+
⚠️ **Security Note**: Images are user-specific and the generated keys must be kept secure - loss of keys means loss of access to the container.
10+
11+
## Quick Start
12+
13+
```bash
14+
# 1. Generate SSH keys
15+
make ssh-keys client-keys
16+
17+
# 2. Build with your UID/GID
18+
make build UID=1060 GID=100
19+
20+
# 3. Test locally
21+
make run
22+
make connect
23+
24+
# 4. Publish to your registry
25+
docker tag ssh-container:latest your-registry.com/ssh-container:latest
26+
docker push your-registry.com/ssh-container:latest
27+
```
28+
29+
## NNF Container Profile
30+
31+
Create a profile referencing your published image:
32+
33+
```yaml
34+
apiVersion: nnf.cray.hpe.com/v1alpha1
35+
kind: NnfContainerProfile
36+
metadata:
37+
name: ssh-container-profile
38+
spec:
39+
containers:
40+
- name: ssh-launcher
41+
image: your-registry.com/ssh-container:latest
42+
ports:
43+
- name: ssh
44+
port: 22
45+
```
46+
47+
## Customization
48+
49+
Add tools by modifying the Dockerfile:
50+
51+
```dockerfile
52+
# Add your tools after the base setup
53+
RUN apt-get update && apt-get install -y \
54+
your-tool \
55+
&& rm -rf /var/lib/apt/lists/*
56+
```

0 commit comments

Comments
 (0)