Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Enable users to disable preview for all when publishing Kedro-Viz #1925

Merged
merged 18 commits into from
Jun 12, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -180,6 +180,7 @@ Options:
--bucket-name TEXT Bucket name where Kedro Viz will be hosted [required]
--include-hooks A flag to include all registered hooks in your Kedro
Project
--include-previews A flag to include preview for all the datasets
-h, --help Show this message and exit.
```

Expand All @@ -195,9 +196,10 @@ Usage: kedro viz build [OPTIONS]
Create build directory of local Kedro Viz instance with Kedro project data

Options:
--include-hooks A flag to include all registered hooks in your Kedro
Project
-h, --help Show this message and exit.
--include-hooks A flag to include all registered hooks in your Kedro
Project
--include-previews A flag to include preview for all the datasets
-h, --help Show this message and exit.
```

### Experiment Tracking usage
Expand Down
Binary file modified docs/source/images/kedro-publish-aws.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/source/images/kedro-publish-azure.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/source/images/kedro-publish-gcp.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions docs/source/platform_agnostic_sharing_with_kedro_viz.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,10 @@ kedro>=0.18.2
kedro viz build
```

```{note}
Starting from Kedro-Viz 9.2.0, `kedro viz build` will not include dataset previews by default. To enable previews for all the datasets, use the `--include-previews` flag.
```

This creates a `build` folder containing your Kedro-Viz app package in your project directory.

## Static website hosting platforms such as GitHub Pages
Expand Down
3 changes: 3 additions & 0 deletions docs/source/preview_datasets.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,3 +57,6 @@ companies:
preview: false
```

```{note}
Starting from Kedro-Viz 9.2.0, previews are disabled by default for the CLI commands `kedro viz deploy` and `kedro viz build`. You can control this behavior using the `--include-previews` flag with these commands. For `kedro viz run`, previews are enabled by default and can be controlled from the publish modal dialog, refer to the [Publish and share](./share_kedro_viz) for more instructions.
```
5 changes: 5 additions & 0 deletions docs/source/publish_and_share_kedro_viz_on_aws.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,7 @@ Set up endpoint
The endpoint link can be found under **S3 bucket -> Properties -> Static website hosting -> Bucket website endpoint**.
```

Before publishing, you can enable or disable the preview for all datasets by toggling the "All dataset previews" button in the modal dialog.
Once those details are complete, click **Publish**. A hosted, shareable URL will be returned to you after the process completes.

![](./images/kedro-publish-aws.gif)
Expand All @@ -105,6 +106,10 @@ If you are on Kedro-Viz 7.0.0 you can still publish and share Kedro-Viz project
kedro viz deploy --region=[aws-bucket-region] --bucket-name=[aws-bucket-name]
```

```{note}
Starting from Kedro-Viz 9.2.0, `kedro viz deploy` will not include dataset previews by default. To enable previews for all the datasets, use the `--include-previews` flag.
```

## Permissions and access control

Kedro-Viz does not manage permissions or access control. AWS manages all permissions and access control. As a user, you have the choice to allow anyone to view your project or restrict access to specific IP addresses, users, or groups.
Expand Down
5 changes: 5 additions & 0 deletions docs/source/publish_and_share_kedro_viz_on_azure.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,7 @@ Set up endpoint
The endpoint link can be found under **Storage account -> Capabilities -> Static website -> Primary endpoint**.
```

Before publishing, you can enable or disable the preview for all datasets by toggling the "All dataset previews" button in the modal dialog.
Once those details are complete, click **Publish**. A hosted, shareable URL will be returned to you after the process completes.

![](./images/kedro-publish-azure.gif)
Expand All @@ -115,6 +116,10 @@ Use the `kedro viz deploy` command to publish Kedro-Viz on Azure. You can execut
kedro viz deploy --platform=azure --endpoint=[azure-endpoint] --bucket-name=[azure-bucket-name]
```

```{note}
Starting from Kedro-Viz 9.2.0, `kedro viz deploy` will not include dataset previews by default. To enable previews for all the datasets, use the `--include-previews` flag.
```

## Permissions and access control

Kedro-Viz does not manage permissions or access control. Azure manages all permissions and access control. As a user, you have the choice to allow anyone to view your project or restrict access to specific IP addresses, users, or groups.
Expand Down
5 changes: 5 additions & 0 deletions docs/source/publish_and_share_kedro_viz_on_gcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,7 @@ The endpoint link can be found under your **Application Load Balancer -> Fronten
If you have set up SSL certificate and serve your site using `HTTPS` then provide your root domain.
```

Before publishing, you can enable or disable the preview for all datasets by toggling the "All dataset previews" button in the modal dialog.
Once those details are complete, click **Publish**. A hosted, shareable URL will be returned to you after the process completes.

![](./images/kedro-publish-gcp.gif)
Expand All @@ -101,6 +102,10 @@ Use the `kedro viz deploy` command to publish Kedro-Viz on GCP. You can execute
kedro viz deploy --platform=gcp --endpoint=[gcp-endpoint] --bucket-name=[gcp-bucket-name]
```

```{note}
Starting from Kedro-Viz 9.2.0, `kedro viz deploy` will not include dataset previews by default. To enable previews for all the datasets, use the `--include-previews` flag.
```

## Permissions and access control

Kedro-Viz does not manage permissions or access control. GCP manages all permissions and access control. As a user, you have the choice to allow anyone to view your project or restrict access to specific IP addresses, users, or groups.
Expand Down
Loading