From 307bb0dea12ff5e27dc3fb292dcec48784a31755 Mon Sep 17 00:00:00 2001 From: Stefan Prodan Date: Mon, 8 Feb 2021 15:40:08 +0200 Subject: [PATCH] Add Azure DevOps PAT auth to install docs Signed-off-by: Stefan Prodan --- docs/guides/installation.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/docs/guides/installation.md b/docs/guides/installation.md index c0093c21..c4f9bece 100644 --- a/docs/guides/installation.md +++ b/docs/guides/installation.md @@ -310,15 +310,13 @@ If you don't specify the SSH algorithm, then `flux` will generate an RSA 2048 bi 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 connection fails with the default configuration. - 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. If you are using Azure DevOps you need to specify a different Git implementation than the default: ```sh flux create source git flux-system \ --git-implementation=libgit2 \ - --url=ssh://git@ssh.dev.azure.com/v3/org/project/repository \ + --url=ssh://git@ssh.dev.azure.com/v3/// \ --branch=master \ --interval=1m ``` @@ -328,6 +326,21 @@ If you don't specify the SSH algorithm, then `flux` will generate an RSA 2048 bi (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 you wish to use Git over HTTPS, then generated a personal access token and supply it as the password: + + ```sh + flux create source git flux-system \ + --git-implementation=libgit2 \ + --url=https://dev.azure.com///_git/ \ + --branch=master \ + --username=git \ + --password=token \ + --interval=1m + ``` + + Please consult the [Azure DevOps documentation](https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=preview-page) + on how to generate personal access tokens for Git repositories. + If your Git server supports basic auth, you can set the URL to HTTPS and specify the credentials with: ```sh