Skip to content

Commit

Permalink
Add Prefect Cloud Quickstart tutorial (#8227)
Browse files Browse the repository at this point in the history
Co-authored-by: Bill Palombi <bill@prefect.io>
  • Loading branch information
2 people authored and zanieb committed Feb 6, 2023
1 parent cf10e19 commit f90b96d
Show file tree
Hide file tree
Showing 3 changed files with 33 additions and 0 deletions.
26 changes: 26 additions & 0 deletions docs/tutorials/deployments.md
Original file line number Diff line number Diff line change
Expand Up @@ -661,6 +661,32 @@ Authenticated with Prefect Cloud! Using workspace 'prefect/terry-prefect-workspa
```
</div>

!!! tip "Blocks and deployments are specific to a server or Prefect Cloud workspace"
Note that, if you ran through this tutorial on a local Prefect Orion server instance, the storage and infrastructure blocks you created would not also be configured on Prefect Cloud. You must configure new storage and infrastructure blocks for any Prefect Cloud workspace.

## Run deployments with Prefect Cloud

The steps in this tutorial also work to apply deployments to Prefect Cloud, which creates the corresponding flow runs.

See the [Prefect Cloud Quickstart](/ui/cloud-quickstart/) for step-by-step instructions to log into Prefect Cloud, create a workspace, and configure your local environment to use Prefect Cloud as the API backend. Then run through this tutorial again, using Prefect Cloud instead of a local Prefect Orion server.

Already have a Prefect Cloud account? Logging in from your local development environment is as easy as `prefect cloud login`:

<div class="terminal">
```shell
$ prefect cloud login
? How would you like to authenticate? [Use arrows to move; enter to select]
> Log in with a web browser
Paste an API key
Opening browser...
Waiting for response...
? Which workspace would you like to use? [Use arrows to move; enter to select]
> prefect/terry-prefect-workspace
g-gadflow/g-workspace
Authenticated with Prefect Cloud! Using workspace 'prefect/terry-prefect-workspace'.
```
</div>

!!! tip "Blocks and deployments are specific to a server or Prefect Cloud workspace"
Note that, if you ran through this tutorial on a local Prefect Orion server instance, the storage and infrastructure blocks you created would not also be configured on Prefect Cloud. You must configure new storage and infrastructure blocks for any Prefect Cloud workspace.

Expand Down
3 changes: 3 additions & 0 deletions docs/tutorials/storage.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,9 @@ Select **Create** to create the new storage block. Prefect displays the details
!!! tip "Blocks and deployments are specific to a server or Prefect Cloud workspace"
Note that, if you ran through this tutorial on a local Prefect Orion server instance, the storage and infrastructure blocks you created would not also be configured on Prefect Cloud. You must configure new storage and infrastructure blocks for any Prefect Cloud workspace.

!!! tip "Blocks and deployments are specific to a server or Prefect Cloud workspace"
Note that, if you ran through this tutorial on a local Prefect Orion server instance, the storage and infrastructure blocks you created would not also be configured on Prefect Cloud. You must configure new storage and infrastructure blocks for any Prefect Cloud workspace.

## Using storage blocks with deployments

To demonstrate using a storage block, we'll create a new variation of the deployment for the `log_flow` example from the [deployments tutorial](/tutorials/deployments/). For this deployment, we'll specify using the storage block created earlier by passing `-sb s3/log-test` or `--storage-block s3/log-test` to the `prefect deployment build` command.
Expand Down
4 changes: 4 additions & 0 deletions docs/ui/cloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,10 @@ Prefect Cloud [automations](/ui/automations/) provide the same notification capa

Prefect Cloud [automations](/ui/automations/) provide the same notification capabilities as the open-source Prefect Orion server, and also enable you to configure triggers and actions that can kick off flow runs, pause deployments, or send custom notifications in response to real-time monitoring events.

## Automations

Prefect Cloud [automations](/ui/automations/) provide the same notification capabilities as the open-source Prefect Orion server, and also enable you to configure triggers and actions that can kick off flow runs, pause deployments, or send custom notifications in response to real-time monitoring events.

## Organizations <span class="badge orgs"></span>

A Prefect Cloud [organization](/ui/organizations/) is a type of account available on Prefect Cloud that enables more extensive and granular control over workspace collaboration. Within an organization account you can:
Expand Down

0 comments on commit f90b96d

Please sign in to comment.