From 497b155355559b84f0d7b4078a62d71b5508558f Mon Sep 17 00:00:00 2001 From: guillaume Date: Fri, 8 Apr 2022 11:29:39 +0200 Subject: [PATCH] Docs: guides/1225-pushing-plan-dependencies Add documentation enforcing the best practice regarding dagger dependencies `cue.mod/pkg` Signed-off-by: guillaume --- docs/guides/1225-pushing-plan-dependencies.md | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 docs/guides/1225-pushing-plan-dependencies.md diff --git a/docs/guides/1225-pushing-plan-dependencies.md b/docs/guides/1225-pushing-plan-dependencies.md new file mode 100644 index 00000000..b764b619 --- /dev/null +++ b/docs/guides/1225-pushing-plan-dependencies.md @@ -0,0 +1,67 @@ +--- +slug: /1225/pushing-plan-dependencies/ +--- + +# Pushing your plan's dependencies + +After completing your plan and setting up your GHA or Gitlab CI, you'll realize that a lot of `Cue` files are present in the `cue.mod/pkg` directory. These are the dependencies required by Dagger to run your actions : + +```shell +cue.mod/ +├── pkg +│ ├── dagger.io +│ │ ├── cue.mod +│ │ └── dagger +│ │ └── core +│ └── universe.dagger.io +│ ├── alpine +│ │ └── test +│ ├── aws +│ │ ├── cli +│ │ │ └── test +│ │ └── test +│ ├── bash +│ │ └── test +│ │ └── data +│ ├── cue.mod +│ ├── docker +│ │ ├── cli +│ │ │ └── test +│ │ └── test +│ ├── examples +│ │ ├── changelog.com +│ │ │ ├── elixir +│ │ │ │ └── mix +│ │ │ └── gerhard +│ │ ├── helloworld +│ │ └── todoapp +│ │ ├── public +│ │ └── src +│ │ └── components +│ ├── git +│ ├── go +│ │ └── test +│ ├── netlify +│ │ └── test +│ │ └── testutils +│ ├── nginx +│ ├── powershell +│ │ └── test +│ │ └── data +│ ├── python +│ ├── x +│ │ └── david@rawkode.dev +│ │ └── pulumi +│ └── yarn +│ └── test +│ └── data +│ ├── bar +│ └── foo +└── usr +``` + +The current best practice is to push your project with these files: it will ensure its consistency between runs. + +:::info +We are aware of that and, soon, `dagger project update` will only download the dependencies required by your actions +:::