terraform/website/source/docs/providers/atlas/r/artifact.html.markdown

81 lines
2.6 KiB
Markdown
Raw Normal View History

2014-12-08 03:42:27 +01:00
---
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"
2014-12-09 02:13:42 +01:00
build = "latest"
2014-12-08 03:42:27 +01:00
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.
2014-12-09 02:13:42 +01:00
* `build` - (Optional) The build to filter on. This can be "latest",
to find a matching artifact in the latest build, "any" to find a
matching artifact in any build, or a specific number to pin to that
build. If `build` and `version` are unspecified, `version` will default
to "latest". Cannot be specified with `version`.
* `version` - (Optional) The version to filter on. This can be "latest",
to match against the latest version, "any" to find a matching artifact
in any version, or a specific number to pin to that version. Defaults to
"latest" if neither `build` or `version` is specified. Cannot be specified
with `build`.
2014-12-08 03:42:27 +01:00
* `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:
* `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.
2014-12-09 04:49:23 +01:00
* `metadata_full` - Contains the full metadata of the artifact. The keys are sanitized
to replace any characters that are invalid in a resource name with a hypen.
For example, the "region.us-east-1" key will become "region-us-east-1".
2014-12-09 02:13:42 +01:00
* `version_real` - The matching version of the artifact
* `slug` - The artifact slug in Atlas
2014-12-08 03:42:27 +01:00