kjuulh/dagger
Archived
1
0
Fork 0
Code Issues 1 Pull Requests 1 Projects Releases Wiki Activity

docs: updated stdlib reference doc

Browse Source 
Signed-off-by: Sam Alba <sam.alba@gmail.com>
This commit is contained in:
Sam Alba 2021-06-15 10:48:54 +02:00
parent 6422b4d36d
commit 7054782547
22 changed files with 116 additions and 63 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/reference/universe/alpine.md
View File

@ -4,8 +4,12 @@ sidebar_label: alpine
# dagger.io/alpine # dagger.io/alpine
Base package for Alpine Linux
## #Image ## #Image
Base image for Alpine Linux
### #Image Inputs ### #Image Inputs
_No input._ _No input._

4
docs/reference/universe/aws/README.md
View File

@ -4,6 +4,8 @@ sidebar_label: aws
# dagger.io/aws # dagger.io/aws
AWS base package
## #CLI ## #CLI
Re-usable aws-cli component Re-usable aws-cli component
@ -22,7 +24,7 @@ _No output._
## #Config ## #Config
Base AWS Config AWS Config shared by all AWS packages
### #Config Inputs ### #Config Inputs

2
docs/reference/universe/aws/cloudformation.md
View File

@ -4,6 +4,8 @@ sidebar_label: cloudformation
# dagger.io/aws/cloudformation # dagger.io/aws/cloudformation
AWS Cloud Formation
## #Stack ## #Stack
AWS CloudFormation Stack AWS CloudFormation Stack

2
docs/reference/universe/aws/ecr.md
View File

@ -4,6 +4,8 @@ sidebar_label: ecr
# dagger.io/aws/ecr # dagger.io/aws/ecr
Amazon Elastic Container Registry (ECR)
## #Credentials ## #Credentials
Convert AWS credentials to Docker Registry credentials for ECR Convert AWS credentials to Docker Registry credentials for ECR

2
docs/reference/universe/aws/ecs.md
View File

@ -3,3 +3,5 @@ sidebar_label: ecs
--- ---
# dagger.io/aws/ecs # dagger.io/aws/ecs
AWS Elastic Container Service (ECS)

2
docs/reference/universe/aws/eks.md
View File

@ -4,6 +4,8 @@ sidebar_label: eks
# dagger.io/aws/eks # dagger.io/aws/eks
AWS Elastic Kubernetes Service (EKS)
## #KubeConfig ## #KubeConfig
KubeConfig config outputs a valid kube-auth-config for kubectl client KubeConfig config outputs a valid kube-auth-config for kubectl client

4
docs/reference/universe/aws/elb.md
View File

@ -4,9 +4,11 @@ sidebar_label: elb
# dagger.io/aws/elb # dagger.io/aws/elb
AWS Elastic Load Balancer (ELBv2)
## #RandomRulePriority ## #RandomRulePriority
Returns a non-taken rule priority (randomized) Returns an unused rule priority (randomized in available range)
### #RandomRulePriority Inputs ### #RandomRulePriority Inputs

48
docs/reference/universe/aws/rds.md
View File

@ -4,19 +4,23 @@ sidebar_label: rds
# dagger.io/aws/rds # dagger.io/aws/rds
AWS Relational Database Service (RDS)
## #CreateDB ## #CreateDB
Creates a new Database on an existing RDS Instance
### #CreateDB Inputs ### #CreateDB Inputs
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*config.region* | `string` |AWS region | |*config.region* | `string` |AWS region |
|*config.accessKey* | `dagger.#Secret` |AWS access key | |*config.accessKey* | `dagger.#Secret` |AWS access key |
|*config.secretKey* | `dagger.#Secret` |AWS secret key | |*config.secretKey* | `dagger.#Secret` |AWS secret key |
|*name* | `string` |DB name | |*name* | `string` |DB name |
|*dbArn* | `string` |ARN of the database instance | |*dbArn* | `string` |ARN of the database instance |
|*secretArn* | `string` |ARN of the database secret (for connecting via rds api) | |*secretArn* | `string` |ARN of the database secret (for connecting via rds api) |
|*dbType* | `string` |- | |*dbType* | `string` |Database type MySQL or PostgreSQL (Aurora Serverless only) |
### #CreateDB Outputs ### #CreateDB Outputs
@ -26,19 +30,21 @@ sidebar_label: rds
## #CreateUser ## #CreateUser
Creates a new user credentials on an existing RDS Instance
### #CreateUser Inputs ### #CreateUser Inputs
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*config.region* | `string` |AWS region | |*config.region* | `string` |AWS region |
|*config.accessKey* | `dagger.#Secret` |AWS access key | |*config.accessKey* | `dagger.#Secret` |AWS access key |
|*config.secretKey* | `dagger.#Secret` |AWS secret key | |*config.secretKey* | `dagger.#Secret` |AWS secret key |
|*username* | `string` |Username | |*username* | `string` |Username |
|*password* | `string` |Password | |*password* | `string` |Password |
|*dbArn* | `string` |ARN of the database instance | |*dbArn* | `string` |ARN of the database instance |
|*secretArn* | `string` |ARN of the database secret (for connecting via rds api) | |*secretArn* | `string` |ARN of the database secret (for connecting via rds api) |
|*grantDatabase* | `*"" \| string` |- | |*grantDatabase* | `*"" \| string` |Name of the database to grants access to |
|*dbType* | `string` |- | |*dbType* | `string` |Database type MySQL or PostgreSQL (Aurora Serverless only) |
### #CreateUser Outputs ### #CreateUser Outputs
@ -48,6 +54,8 @@ sidebar_label: rds
## #Instance ## #Instance
Fetches information on an existing RDS Instance
### #Instance Inputs ### #Instance Inputs
| Name | Type | Description | | Name | Type | Description |

6
docs/reference/universe/aws/s3.md
View File

@ -4,9 +4,11 @@ sidebar_label: s3
# dagger.io/aws/s3 # dagger.io/aws/s3
AWS Simple Storage Service
## #Put ## #Put
S3 file or Directory upload S3 Bucket upload (file or directory)
### #Put Inputs ### #Put Inputs
@ -27,7 +29,7 @@ S3 file or Directory upload
## #Sync ## #Sync
S3 Sync S3 Bucket sync
### #Sync Inputs ### #Sync Inputs

10
docs/reference/universe/docker.md
View File

@ -4,6 +4,8 @@ sidebar_label: docker
# dagger.io/docker # dagger.io/docker
Docker container operations
## #Build ## #Build
Build a Docker image from source, using included Dockerfile Build a Docker image from source, using included Dockerfile
@ -38,10 +40,10 @@ Build a Docker image from the provided Dockerfile contents
### #ImageFromDockerfile Inputs ### #ImageFromDockerfile Inputs
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*dockerfile* | `string` |- | |*dockerfile* | `string` |Dockerfile passed as a string |
|*context* | `dagger.#Artifact` |- | |*context* | `dagger.#Artifact` |Build context |
### #ImageFromDockerfile Outputs ### #ImageFromDockerfile Outputs

2
docs/reference/universe/gcp/README.md
View File

@ -4,6 +4,8 @@ sidebar_label: gcp
# dagger.io/gcp # dagger.io/gcp
Google Cloud Platform
## #Config ## #Config
Base Google Cloud Config Base Google Cloud Config

2
docs/reference/universe/gcp/gcr.md
View File

@ -4,6 +4,8 @@ sidebar_label: gcr
# dagger.io/gcp/gcr # dagger.io/gcp/gcr
Google Container Registry
## #Credentials ## #Credentials
Credentials retriever for GCR Credentials retriever for GCR

2
docs/reference/universe/gcp/gke.md
View File

@ -4,6 +4,8 @@ sidebar_label: gke
# dagger.io/gcp/gke # dagger.io/gcp/gke
Google Kubernetes Engine
## #KubeConfig ## #KubeConfig
KubeConfig config outputs a valid kube-auth-config for kubectl client KubeConfig config outputs a valid kube-auth-config for kubectl client

10
docs/reference/universe/git.md
View File

@ -4,6 +4,8 @@ sidebar_label: git
# dagger.io/git # dagger.io/git
Git operations
## #CurrentBranch ## #CurrentBranch
Get the name of the current checked out branch or tag Get the name of the current checked out branch or tag
@ -12,13 +14,13 @@ Get the name of the current checked out branch or tag
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*repository* | `dagger.#Artifact` |- | |*repository* | `dagger.#Artifact` |Git repository |
### #CurrentBranch Outputs ### #CurrentBranch Outputs
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*name* | `string` |- | |*name* | `string` |Git branch name |
## #Repository ## #Repository
@ -44,10 +46,10 @@ List tags of a repository
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*repository* | `dagger.#Artifact` |- | |*repository* | `dagger.#Artifact` |Git repository |
### #Tags Outputs ### #Tags Outputs
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*tags* | `[]` |- | |*tags* | `[]` |Repository tags |

8
docs/reference/universe/go.md
View File

@ -4,8 +4,12 @@ sidebar_label: go
# dagger.io/go # dagger.io/go
Go build operations
## #Build ## #Build
Go application builder
### #Build Inputs ### #Build Inputs
| Name | Type | Description | | Name | Type | Description |
@ -33,7 +37,7 @@ A standalone go environment
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*version* | `*"1.16" \| string` |Go version to use | |*version* | `*"1.16" \| string` |Go version to use |
|*source* | `dagger.#Artifact` |- | |*source* | `dagger.#Artifact` |Source code |
|*image.from* | `"docker.io/golang:1.16-alpine"` |Remote ref (example: "index.docker.io/alpine:latest") | |*image.from* | `"docker.io/golang:1.16-alpine"` |Remote ref (example: "index.docker.io/alpine:latest") |
### #Container Outputs ### #Container Outputs
@ -42,6 +46,8 @@ _No output._
## #Go ## #Go
Re-usable component for the Go compiler
### #Go Inputs ### #Go Inputs
| Name | Type | Description | | Name | Type | Description |

8
docs/reference/universe/io.md
View File

@ -4,6 +4,8 @@ sidebar_label: io
# dagger.io/io # dagger.io/io
IO operations
## #Dir ## #Dir
Standard interface for directory operations in cue Standard interface for directory operations in cue
@ -30,6 +32,8 @@ _No output._
## #ReadWriter ## #ReadWriter
Standard ReadWriter interface
### #ReadWriter Inputs ### #ReadWriter Inputs
_No input._ _No input._
@ -40,6 +44,8 @@ _No output._
## #Reader ## #Reader
Standard Reader interface
### #Reader Inputs ### #Reader Inputs
_No input._ _No input._
@ -50,6 +56,8 @@ _No output._
## #Writer ## #Writer
Standard Writer interface
### #Writer Inputs ### #Writer Inputs
_No input._ _No input._

28
docs/reference/universe/js/yarn.md
View File

@ -8,23 +8,23 @@ Yarn is a package manager for Javascript applications
## #Package ## #Package
A Yarn package. A Yarn package
### #Package Inputs ### #Package Inputs
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*source* | `dagger.#Artifact` |Application source code | |*source* | `dagger.#Artifact` |Application source code |
|*package* | `struct` |Extra alpine packages to install | |*package* | `struct` |Extra alpine packages to install |
|*cwd* | `*"." \| string` |working directory to use | |*cwd* | `*"." \| string` |working directory to use |
|*env* | `struct` |Environment variables | |*env* | `struct` |Environment variables |
|*writeEnvFile* | `*"" \| string` |Write the contents of `environment` to this file, in the "envfile" format. | |*writeEnvFile* | `*"" \| string` |Write the contents of `environment` to this file, in the "envfile" format |
|*buildDir* | `*"build" \| string` |Read build output from this directory (path must be relative to working directory). | |*buildDir* | `*"build" \| string` |Read build output from this directory (path must be relative to working directory) |
|*script* | `*"build" \| string` |Run this yarn script | |*script* | `*"build" \| string` |Run this yarn script |
|*args* | `*[] \| []` |Optional arguments for the script | |*args* | `*[] \| []` |Optional arguments for the script |
### #Package Outputs ### #Package Outputs
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*build* | `struct` |- | |*build* | `struct` |Build output directory |

4
docs/reference/universe/kubernetes/README.md
View File

@ -4,8 +4,12 @@ sidebar_label: kubernetes
# dagger.io/kubernetes # dagger.io/kubernetes
Kubernetes client operations
## #Kubectl ## #Kubectl
Kubectl client
### #Kubectl Inputs ### #Kubectl Inputs
_No input._ _No input._

2
docs/reference/universe/kubernetes/kustomize.md
View File

@ -4,6 +4,8 @@ sidebar_label: kustomize
# dagger.io/kubernetes/kustomize # dagger.io/kubernetes/kustomize
Kustomize config management
## #Kustomization ## #Kustomization
### #Kustomization Inputs ### #Kustomization Inputs

6
docs/reference/universe/netlify.md
View File

@ -4,9 +4,11 @@ sidebar_label: netlify
# dagger.io/netlify # dagger.io/netlify
Netlify client operations
## #Account ## #Account
A Netlify account Netlify account credentials
### #Account Inputs ### #Account Inputs
@ -21,7 +23,7 @@ _No output._
## #Site ## #Site
A Netlify site Netlify site
### #Site Inputs ### #Site Inputs

11
docs/reference/universe/random.md
View File

@ -4,16 +4,7 @@ sidebar_label: random
# dagger.io/random # dagger.io/random
Random generation utilities. Random generation utilities
Example:
```cue
str: random.#String & {
seed: "str"
length: 10
}
```
## #String ## #String

12
docs/reference/universe/terraform.md
View File

@ -4,14 +4,18 @@ sidebar_label: terraform
# dagger.io/terraform # dagger.io/terraform
Terraform operations
## #Configuration ## #Configuration
Terraform configuration
### #Configuration Inputs ### #Configuration Inputs
| Name | Type | Description | | Name | Type | Description |
| ------------- |:-------------: |:-------------: | | ------------- |:-------------: |:-------------: |
|*version* | `*"latest" \| string` |- | |*version* | `*"latest" \| string` |Terraform version |
|*source* | `dagger.#Artifact` |- | |*source* | `dagger.#Artifact` |Source configuration |
### #Configuration Outputs ### #Configuration Outputs