From 438877674a1cf4bc991cb6e76717619d210b1ab0 Mon Sep 17 00:00:00 2001 From: Sanskar Jaiswal Date: Thu, 17 Feb 2022 20:36:13 +0530 Subject: [PATCH] add docs Signed-off-by: Sanskar Jaiswal --- .gitbook.yaml | 1 + docs/diagrams/flagger-gatewayapi-canary.png | Bin 0 -> 40335 bytes docs/gitbook/SUMMARY.md | 1 + .../gatewayapi-progressive-delivery.md | 314 ++++++++++++++++++ docs/gitbook/usage/deployment-strategies.md | 6 +- 5 files changed, 319 insertions(+), 3 deletions(-) create mode 100644 docs/diagrams/flagger-gatewayapi-canary.png create mode 100644 docs/gitbook/tutorials/gatewayapi-progressive-delivery.md diff --git a/.gitbook.yaml b/.gitbook.yaml index 725a7458..1a7d9933 100644 --- a/.gitbook.yaml +++ b/.gitbook.yaml @@ -15,3 +15,4 @@ redirects: usage/traefik-progressive-delivery: tutorials/traefik-progressive-delivery.md usage/osm-progressive-delivery: tutorials/osm-progressive-delivery.md usage/kuma-progressive-delivery: tutorials/kuma-progressive-delivery.md + usage/gatewayapi-progressive-delivery: tutorials/gatewayapi-progressive-delivery.md diff --git a/docs/diagrams/flagger-gatewayapi-canary.png b/docs/diagrams/flagger-gatewayapi-canary.png new file mode 100644 index 0000000000000000000000000000000000000000..75814464d66cf073e668d22cf7132239324e7b8b GIT binary patch literal 40335 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
    fo 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