Publish and share on AWS¶

This page describes how to publish Kedro-Viz on AWS to share it with others. It uses the spaceflights tutorial as an example.

Setup your kedro project¶

If you haven’t installed Kedro follow the documentation to get set up.

Important

We recommend that you use the same version of Kedro that was most recently used to test this tutorial (0.19.1). To check the version installed, type kedro -V in your terminal window.

In your terminal window, navigate to the folder you want to store the project. Generate the spaceflights tutorial project with all the code in place by using the Kedro starter for the spaceflights tutorial:

kedro new --starter=spaceflights-pandas

When prompted for a project name, you can enter anything, but we will assume Spaceflights throughout.

When your project is ready, navigate to the root directory of the project. Install the dependencies from the project root directory by typing the following in your terminal:

pip install -r requirements.txt

Kedro-Viz requires specific minimum versions of fsspec, and kedro to publish your project. Ensure you have these correct versions by updating the requirements.txt file of the Kedro project to add the following:

fsspec>=2023.9.0
kedro>=0.18.2

Install cloud dependencies¶

pip install 'kedro-viz[aws]'

Configure your AWS S3 bucket¶

Create S3 bucket: Follow the AWS tutorial to create an S3 bucket and enable static website hosting.

Note

The process of uploading your site’s files will be done through Kedro-Viz.

Set IAM user: Sign in to the AWS Management Console and create an IAM user account. Refer to the official AWS documentation about IAM Identities.
Generate access keys: Create an IAM user groups with full access to the AWS S3 policy. Add the IAM user to the group and generate access keys. Refer to AWS documentation for detailed instructions on creating and managing access keys.

Set credentials¶

Once that’s completed, you’ll need to set your AWS credentials as environment variables in your terminal window, as shown below:

export AWS_ACCESS_KEY_ID="your_access_key_id"
export AWS_SECRET_ACCESS_KEY="your_secret_access_key"

For more information, see the official AWS documentation about how to work with credentials.

Set up endpoint¶

Important

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.

Note

On Kedro-Viz version 7.0.0, you will see a modal dialog to select your region and bucket name.

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.

Control who can access your visualization using bucket and user policies or access control lists. Refer to the official AWS documentation for further details.

Billing¶

Kedro-Viz does not handle billing. You pay for storing objects in your S3 buckets. The amount you pay depends on your objects’ size, how long you stored the object during the month, and the storage class.

See the official AWS documentation for more information.