This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
dagger/pkg/universe.dagger.io
Andrea Luzzardi d79de11fa8
Merge pull request #1971 from vdemeester/universe-go-fix
universe: go: add git by default in go.#Image
2022-04-04 15:31:42 -07:00
..
alpine Move core actions to a subpackage 2022-03-27 17:33:47 +00:00
aws Move core actions to a subpackage 2022-03-27 17:33:47 +00:00
bash Move core actions to a subpackage 2022-03-27 17:33:47 +00:00
cue.mod Apply Solomon comments 2022-03-18 11:59:11 +01:00
docker copy: support for include/exclude 2022-03-31 18:13:49 -07:00
examples examples: set as vendored to not count in repository stats 2022-03-29 15:56:56 -07:00
git Move core actions to a subpackage 2022-03-27 17:33:47 +00:00
go universe: go: add git by default in go.#Image 2022-04-04 00:44:33 +02:00
netlify ci: Unify keys and add private key for testing purposes 2022-03-30 19:18:32 -03:00
nginx europa: vendor universe.dagger.io 2022-01-11 18:09:09 -08:00
powershell Move core actions to a subpackage 2022-03-27 17:33:47 +00:00
python Simplify docker.#Run 2022-02-08 01:35:51 +00:00
x/david@rawkode.dev/pulumi fix: tidy up a little 2022-04-01 21:09:59 +01:00
yarn Move core actions to a subpackage 2022-03-27 17:33:47 +00:00
.gitignore test: Fix universe tests 2022-03-11 12:41:45 -08:00
bats_helpers.bash Fix export cache issue 2022-03-31 20:36:50 +02:00
package.json Fix export cache issue 2022-03-31 20:36:50 +02:00
README.md docs: fix broken link in universe README.md 2022-04-03 16:54:51 +10:00
secrets_sops.yaml Implemented universe/aws and universe/aws/cli 2022-02-23 14:36:27 -07:00
yarn.lock tests: Basic test infrastructure for Europa Universe 2022-01-19 12:39:39 -08:00

Europa Universe

About this directory

europa-universe/ is a staging area for the upcoming universe.dagger.io package namespace, which will be shipped as part of the Europa release.

What is Universe?

The Dagger Universe is a catalog of reusable Cue packages, curated by Dagger but possibly authored by third parties. Most packages in Universe contain reusable actions; some may also contain entire configuration templates.

The import domain for Universe will be universe.dagger.io. It will deprecate the current domain alpha.dagger.io.

Where is the dagger package?

Europa will also introduce a new package for the Dagger Core API: dagger.io/dagger. This is a core package, and is not part of Universe (note the import domain).

The development version of the Europa core API can be imported as alpha.dagger.io/europa/dagger.

Where is the dagger/engine package?

Europa will also introduce a new package for the Low-Level Dagger Engine API : dagger.io/dagger/engine. This is a core package, and is not part of Universe (note the import domain).

The development version of the Europa Low-Level Engine API can be imported as either:

Universe vs other packages

This table compares Dagger core packages, Dagger Universe packages, and the overall CUE package ecosystem.

Dagger core Dagger Universe CUE ecosystem
Import path dagger.io universe.dagger.io Everything else
Purpose Access core Dagger features Safely reuse code from the Dagger community Reuse any CUE code from anyone
Author Dagger team Dagger community, curated by Dagger Anyone
Release cycle Released with Dagger engine Released continuously No release cycle
Size Small Large Very large
Growth rate Grows slowly, with engine features Grows fast, with Dagger community Grows even faster, with CUE ecosystem

Notable packages

Docker API

Import path: universe.dagger.io/docker

The docker package is a native Cue API for Docker. You can use it to build, run, push and pull Docker containers directly from Cue.

The Dagger container API defines the following types:

  • #Image: a container image
  • #Run: run a command in a container
  • #Push: upload an image to a repository
  • #Pull: download an image from a repository
  • #Build: build an image

Examples

Import path: universe.dagger.io/examples

This package contains examples of complete Dagger configurations, including the result of following tutorials in the documentations.

For example, the todoapp example corresponds to the Getting Started tutorial

TODO LIST

  • Support native language dev in docker.#Run with good DX (Python, Go, Typescript etc.)
  • Coding style. When to use verbs vs. nouns?
  • Easy file injection API (container.#Image.files ?)
  • Use file injection instead of inline for #Command.script (to avoid hitting arg character limits)
  • Organize universe packages in sub-categories?