Skip to content

Commit d50da89

Browse files
authored
Merge pull request #204 from HarperDB/fix-ssh-key-host
Clarified host value explanation for add and update ssh key
2 parents bdfb61c + 89e77e1 commit d50da89

File tree

1 file changed

+9
-13
lines changed

1 file changed

+9
-13
lines changed

docs/developers/operations-api/components.md

Lines changed: 9 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -47,10 +47,12 @@ or this can be shortened to:
4747
HarperDB/application-template#semver:v1.0.0
4848
```
4949

50-
You can also install from private repository if you have an installed SSH keys on the server:
50+
You can also install from private repository if you have installed SSH keys on the server. Ensure the `host` portion of the url exactly matches the `host` used when adding ssh keys to ensure proper authentication.
5151

5252
```
5353
git+ssh://[email protected]:my-org/my-app.git#semver:v1.0.0
54+
55+
git+ssh://[email protected]:my-org/my-app.git#semver:v1.0.0
5456
```
5557

5658
Or you can use a Github token:
@@ -328,19 +330,10 @@ _Operation is restricted to super_user roles only_
328330
- operation _(required)_ - must always be `add_ssh_key`
329331
- name _(required)_ - the name of the key
330332
- key _(required)_ - the private key contents. Must be an ed25519 key. Line breaks must be delimited with `\n` and have a trailing `\n`
331-
- host _(required)_ - the host for the ssh config (see below). Used as part of the `package` url when deploying a component using this key
333+
- host _(required)_ - the host for the ssh config (see below). Used as part of the `package` url when deploying a component using this key.
332334
- hostname _(required)_ - the hostname for the ssh config (see below). Used to map `host` to an actual domain (e.g. `github.com`)
333-
- known*hosts *(optional)\_ - the public SSH keys of the host your component will be retrieved from. If `hostname` is `github.com` this will be retrieved automatically. Line breaks must be delimited with `\n`
335+
- known_hosts _(optional)_ - the public SSH keys of the host your component will be retrieved from. If `hostname` is `github.com` this will be retrieved automatically. Line breaks must be delimited with `\n`
334336
- replicated _(optional)_ - if true, HarperDB will replicate the key to all nodes in the cluster. Must be a boolean.
335-
_Operation is restricted to super_user roles only_
336-
337-
* operation _(required)_ - must always be `add_ssh_key`
338-
* name _(required)_ - the name of the key
339-
* key _(required)_ - the private key contents. Line breaks must be delimited with 
340-
* host _(required)_ - the host for the ssh config (see below). Used as part of the `package` url when deploying a component using this key
341-
* hostname _(required)_ - the hostname for the ssh config (see below). Used to map `host` to an actual domain (e.g. `github.com`)
342-
* known_hosts _(optional)_ - the public SSH keys of the host your component will be retrieved from. If `hostname` is `github.com` this will be retrieved automatically. Line breaks must be delimited with 
343-
* replicated _(optional)_ - if true, Harper will replicate the key to all nodes in the cluster. Must be a boolean.
344337

345338
### Body
346339

@@ -392,7 +385,10 @@ _Operation is restricted to super_user roles only_
392385
- operation _(required)_ - must always be `update_ssh_key`
393386
- name _(required)_ - the name of the key to be updated
394387
- key _(required)_ - the private key contents. Must be an ed25519 key. Line breaks must be delimited with `\n` and have a trailing `\n`
395-
- replicated _(optional)_ - if true, Harper will replicate the key update to all nodes in the cluster. Must be a boolean.
388+
- host _(required)_ - the host for the ssh config (see below). Used as part of the `package` url when deploying a component using this key.
389+
- hostname _(required)_ - the hostname for the ssh config (see below). Used to map `host` to an actual domain (e.g. `github.com`)
390+
- known_hosts _(optional)_ - the public SSH keys of the host your component will be retrieved from. If `hostname` is `github.com` this will be retrieved automatically. Line breaks must be delimited with `\n`
391+
- replicated _(optional)_ - if true, HarperDB will replicate the key to all nodes in the cluster. Must be a boolean.
396392

397393
### Body
398394

0 commit comments

Comments
 (0)