cdn: passthrough and clean up for use of new action

Co-authored-by: Kim Tore Jensen <[email protected]>

Author: tronghn

docs/explanation/cdn.md

@@ -0,0 +1,20 @@
+---
+tags:
+- CDN
+---
+
+# Content Delivery Network (CDN)
+
+A content delivery network (CDN) is a service for serving static content and single-page applications (SPA).
+
+NAIS offers CDN as a service through Google
+Cloud CDN. The CDN is used for serving static content such as HTML
+files, JavaScript libraries and files, stylesheets, and images.
+
+Assets are deployed by uploading them to a bucket using a GitHub
+action.
+
+## What's next?
+
+- :dart: Learn how to [upload assets to the CDN](../how-to-guides/cdn.md)
+- :computer: [CDN Reference documentation](../reference/cdn.md)

docs/explanation/workloads/README.md

@@ -9,6 +9,3 @@ A [NAIS application](./application.md) is a used for long-running processes such
 
 ## NAIS job
 A [NAIS job](./job.md) is used for tasks meant to complete and then exit. This can either run as a one-off task or on a schedule. 
-
-## NAIS CDN
-[NAIS CDN](./cdn.md) offers a way to serve static content and single-page applications (SPA).

docs/explanation/workloads/cdn.md

@@ -0,0 +1,61 @@
+---
+tags:
+- CDN
+---
+
+# Upload assets to the CDN
+
+This how-to guide shows you how to upload assets to the [CDN](../explanation/cdn.md).
+
+## 0. Prerequisites
+
+- A [NAIS team](team.md).
+- A GitHub repository that the team has access to.
+- The repository needs to have a [GitHub workflow](github-action.md#2-create-a-github-workflow) that builds the assets you want to upload.
+
+## 1. Authorize repository for upload
+
+1. Open [NAIS console](https://console.<<tenant()>>.cloud.nais.io) in your browser and select your team.
+2. Select the `Repositories` tab
+3. Find the repository you want to deploy from, and click `Authorize`
+
+## 2. Upload assets with the CDN action
+
+In your Github Workflow, add the following step to upload your assets to the CDN:
+
+```yaml
+- name: Upload static files to NAV CDN
+  uses: nais/deploy/actions/cdn-upload/v2@master
+  with:
+    team: <team slug> # Required, e.g. "team-name"
+    tenant: <<tenant()>> # Optional, defaults to "nav"
+    source: <The path to your build folder or assets>
+    destination: <A destination you pick, like /my-app/dist>
+    project_id: ${{ vars.NAIS_MANAGEMENT_PROJECT_ID }} # Provided as Organization Secret
+    identity_provider: ${{ secrets.NAIS_WORKLOAD_IDENTITY_PROVIDER }} # Provided as Organization Variable
+```
+
+For more information on the inputs and outputs of the action, see the [CDN Reference](../reference/cdn.md).
+
+## 3. Use the uploaded assets
+
+The assets from the CDN will be available at 
+
+{% if tenant() == "nav" %}
+```
+https://cdn.nav.no/<team>/<destination>
+```
+
+and
+
+```
+https://cdn.<<tenant()>>.cloud.nais.io/<team>/<destination>
+```
+{% else %}
+```
+https://cdn.<<tenant()>>.cloud.nais.io/<team>/<destination>
+```
+{% endif %}
+
+CORS is automatically configured to accept `GET` from any
+origin (*).

docs/how-to-guides/CDN.md

@@ -3,25 +3,37 @@ tags:
   - CDN
 ---
 
-# CDN
+# Content Delivery Network (CDN)
 
-Reference documentation for the [CDN](../explanation/workloads/cdn.md) deploy action.
+This is the reference documentation for the [CDN](../explanation/cdn.md) service.
 
-## Inputs
+## How-to guides
+
+- :dart: [Upload assets to the CDN](../how-to-guides/cdn.md)
+
+## CDN Deploy Action
+
+Reference documentation for the CDN GitHub action.
+
+### Inputs
 
 The action accepts the following inputs:
 
-| input              | description                                             | default | required |
-|--------------------|---------------------------------------------------------|---------|----------|
-| team-name          | Team name                                               | ❌       | true     |
-| destination        | Destination directory                                   | ❌       | true     |
-| source             | Source directory                                        | ❌       | true     |
-| cache-invalidation | Invalidate cached content after upload                  | `false` | false    |
-| no-cache-paths     | Comma separated list of paths that should not be cached | `""`    | false    |
+| input                   | description                                                | default | required |
+|-------------------------|------------------------------------------------------------|---------|----------|
+| team                    | Team name                                                  | ❌       | true     |
+| tenant                  | Tenant name                                                | `"nav"` | false    |
+| source                  | Source directory                                           | ❌       | true     |
+| destination             | Destination directory                                      | ❌       | true     |
+| source_keep_parent_name | Keep parent directory name when uploading                  | `true`  | false    |
+| cache_invalidation      | Invalidate cached content after upload                     | `false` | false    |
+| no_cache_paths          | Comma separated list of paths that should not be cached    | `""`    | false    |
+| project_id              | Should be `${{ vars.NAIS_MANAGEMENT_PROJECT_ID }}`         | `""`    | true     |
+| identity_provider       | Should be `${{ secrets.NAIS_WORKLOAD_IDENTITY_PROVIDER }}` | `""`    | true     |
 
-## Outputs
+### Outputs
 
-### `uploaded`
+#### `uploaded`
 
 List of successfully uploaded files.
 
@@ -32,7 +44,7 @@ For example:
 ```yaml
 - id: 'upload-cdn'
   name: Upload static files to NAV CDN
-  uses: navikt/frontend/actions/cdn-upload/v2
+  uses: nais/deploy/actions/cdn-upload/v2@master
   ...
 ```