69 lines
1.9 KiB
Markdown
69 lines
1.9 KiB
Markdown
|
---
|
||
|
|
layout: "atlas"
|
||
|
|
page_title: "Atlas: atlas_artifact"
|
||
|
|
sidebar_current: "docs-atlas-resource-artifact"
|
||
|
|
description: |-
|
||
|
|
Provides access to deployment artifacts managed by Atlas. This can
|
||
|
|
be used to dynamically configure instantiation and provisioning
|
||
|
|
of resources.
|
||
|
|
---
|
||
|
|
|
||
|
|
# atlas\_artifact
|
||
|
|
|
||
|
|
Provides access to deployment artifacts managed by Atlas. This can
|
||
|
|
be used to dynamically configure instantiation and provisioning
|
||
|
|
of resources.
|
||
|
|
|
||
|
|
## Example Usage
|
||
|
|
|
||
|
|
```
|
||
|
|
# Read the AMI
|
||
|
|
resource "atlas_artifact" "web" {
|
||
|
|
name = "hashicorp/web"
|
||
|
|
type = "aws.ami"
|
||
|
|
metadata {
|
||
|
|
arch = "386"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
# Start our instance with the dynamic ami value
|
||
|
|
resource "aws_instance" "app" {
|
||
|
|
ami = "${atlas_artifact.web.id}"
|
||
|
|
...
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Argument Reference
|
||
|
|
|
||
|
|
The following arguments are supported:
|
||
|
|
|
||
|
|
* `name` - (Required) Name of the artifact in Atlas. This is given
|
||
|
|
in slug format like "organization/artifact".
|
||
|
|
|
||
|
|
* `type` - (Required) The type of artifact to query for.
|
||
|
|
|
||
|
|
* `version` - (Optional) By default, if no version is provided the
|
||
|
|
latest version of the artifact is used. Providing a version can
|
||
|
|
be used to pin a dependency.
|
||
|
|
|
||
|
|
* `metadata_keys` - (Optional) If given, only an artifact containing
|
||
|
|
the given keys will be returned. This is used to disambiguate when
|
||
|
|
multiple potential artifacts match. An example is "aws" to filter
|
||
|
|
on an AMI.
|
||
|
|
|
||
|
|
* `metadata` - (Optional) If given, only an artifact matching the
|
||
|
|
metadata filters will be returned. This is used to disambiguate when
|
||
|
|
multiple potential artifacts match. An example is "arch" = "386" to
|
||
|
|
filter on architecture.
|
||
|
|
|
||
|
|
|
||
|
|
## Attributes Reference
|
||
|
|
|
||
|
|
The following attributes are exported:
|
||
|
|
|
||
|
|
* `version` - The matching version of the artifact
|
||
|
|
* `id` - The ID of the artifact. This could be an AMI ID, GCE Image ID, etc.
|
||
|
|
* `file_url` - For artifacts that are binaries, this is a download path.
|
||
|
|
* `metadata_full` - Contains the full metadata of the artifact.
|
||
|
|
|