Mirrors/flux2
1
0
Fork 0
mirror of synced 2026-02-13 13:06:56 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fix Azure DevOps SSH URL in docs

Browse Source 
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
This commit is contained in:
Stefan Prodan
2020-12-14 16:58:41 +02:00
parent f188e59b21
commit 1a7f253767
2 changed files with 18 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/guides/installation.md
View File

@@ -292,13 +292,16 @@ Create a `GitRepository` object on your cluster by specifying the SSH address of
```sh ```sh
flux create source git flux-system \ flux create source git flux-system \
--url= ssh://<host>/<org>/my-repository \ --url=ssh://git@<host>/<org>/<repository> \
--ssh-key-algorithm=ecdsa \ --ssh-key-algorithm=ecdsa \
--ssh-ecdsa-curve=p521 \ --ssh-ecdsa-curve=p521 \
--branch=master \ --branch=master \
--interval=1m --interval=1m
``` ```
You will be prompted to add a deploy key to your repository.
If you don't specify the SSH algorithm, then `flux` will generate an RSA 2048 bits key.
!!! hint "Azure DevOps" !!! hint "Azure DevOps"
Azure DevOps requires a non-default Git implementation (`libgit2`) to be enabled, so that the Git v2 protocol is supported. Azure DevOps requires a non-default Git implementation (`libgit2`) to be enabled, so that the Git v2 protocol is supported.
Note that this implementation does not support shallow cloning, and it is therefore advised to only resort to this option if a Note that this implementation does not support shallow cloning, and it is therefore advised to only resort to this option if a
@@ -306,20 +309,20 @@ flux create source git flux-system \
Additionally, the current implementation of image automation does not support Azure DevOps as has no Git implementation with Additionally, the current implementation of image automation does not support Azure DevOps as has no Git implementation with
this protocol. This limitation will likely change in the future. this protocol. This limitation will likely change in the future.
If you are using Azure DevOps you need to specify a different git implementation than the default: If you are using Azure DevOps you need to specify a different Git implementation than the default:
```sh ```sh
flux create source git flux-system \ flux create source git flux-system \
--url= ssh://<host>/<org>/my-repository \ --git-implementation=libgit2 \
--ssh-key-algorithm=ecdsa \ --url=git@ssh.dev.azure.com/v3/org/project/repository \
--ssh-ecdsa-curve=p521 \
--branch=master \ --branch=master \
--interval=1m \ --interval=1m
--git-implementation=libgit2
``` ```
You will be prompted to add a deploy key to your repository. Note that unlike `git`, Flux does not support the
If you don't specify the SSH algorithm, then `flux` will generate an RSA 2048 bits key. ["shorter" scp-like syntax for the SSH protocol](https://git-scm.com/book/en/v2/Git-on-the-Server-The-Protocols#_the_ssh_protocol)
(e.g. `ssh.dev.azure.com:v3`).
Use the [RFC 3986 compatible syntax](https://tools.ietf.org/html/rfc3986#section-3) instead: `ssh.dev.azure.com/v3`.
If your Git server supports basic auth, you can set the URL to HTTPS and specify the credentials with: If your Git server supports basic auth, you can set the URL to HTTPS and specify the credentials with:

1
mkdocs.yml
View File

@@ -37,6 +37,7 @@ markdown_extensions:
- pymdownx.tilde - pymdownx.tilde
- pymdownx.progressbar - pymdownx.progressbar
- pymdownx.tasklist - pymdownx.tasklist
- pymdownx.superfences
- pymdownx.emoji: - pymdownx.emoji:
emoji_index: !!python/name:materialx.emoji.twemoji emoji_index: !!python/name:materialx.emoji.twemoji
emoji_generator: !!python/name:materialx.emoji.to_svg emoji_generator: !!python/name:materialx.emoji.to_svg