Skip to content

Commit

Permalink
docs: update dev documentation for test phase; (#6538)
Browse files Browse the repository at this point in the history
add links
  • Loading branch information
gsquared94 authored Aug 30, 2021
1 parent 5b42546 commit ca02f67
Showing 1 changed file with 6 additions and 5 deletions.
11 changes: 6 additions & 5 deletions docs/content/en/docs/workflows/dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,25 +7,26 @@ weight: 20

`skaffold dev` enables continuous local development on an application.
While in `dev` mode, Skaffold will watch an application's source files, and when it detects changes,
will rebuild your images (or sync files to your running containers), push any new images, and redeploy the application to your cluster.
will rebuild your images (or sync files to your running containers), push any new images, test built images, and redeploy the application to your cluster.

`skaffold dev` is considered Skaffold's main mode of operation, as it allows you
to leverage all of the features of Skaffold in a continuous way while iterating
on your application.

## Dev loop

When `skaffold dev` is run, Skaffold will first do a full build and deploy of all artifacts specified in the `skaffold.yaml`, similar to `skaffold run`. Upon successful build and deploy, Skaffold will start watching all source file dependencies for all artifacts specified in the project. As changes are made to these source files, Skaffold will rebuild the associated artifacts, and redeploy the new changes to your cluster.
When `skaffold dev` is run, Skaffold will first do a full build, test and deploy of all artifacts specified in the `skaffold.yaml`, similar to `skaffold run`. Upon successful build, test and deploy, Skaffold will start watching all source file dependencies for all artifacts specified in the project. As changes are made to these source files, Skaffold will rebuild and retest the associated artifacts, and redeploy the new changes to your cluster.

The dev loop will run until the user cancels the Skaffold process with `Ctrl+C`. Upon receiving this signal, Skaffold will clean up all deployed artifacts on the active cluster, meaning that Skaffold won't abandon any Kubernetes resources that it created throughout the lifecycle of the run. This can be optionally disabled by using the `--no-prune` flag.

## Precedence of Actions

The actions performed by Skaffold during the dev loop have precedence over one another, so that behavior is always predictable. The order of actions is:

1. File Sync
1. Build
1. Deploy
1. [File Sync]({{<relref "/docs/pipeline-stages/filesync" >}})
1. [Build]({{<relref "/docs/pipeline-stages/builders" >}})
1. [Test]({{<relref "/docs/pipeline-stages/testers" >}})
1. [Deploy]({{<relref "/docs/pipeline-stages/deployers" >}})

## File Watcher and Watch Modes

Expand Down

0 comments on commit ca02f67

Please sign in to comment.