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

87 lines
3.0 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
2015-04-21 23:39:22 +02:00
An artifact can be created that has metadata representing
an AMI in AWS. This AMI can be used to configure an instance. Any changes
to this artifact will trigger a change to that instance.
2014-12-08 03:42:27 +01:00
```
# Read the AMI
resource "atlas_artifact" "web" {
name = "hashicorp/web"
2015-09-08 23:23:25 +02:00
type = "amazon.image"
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
# Remember to include the AWS region as it is part of the full ID
2014-12-08 03:42:27 +01:00
resource "aws_instance" "app" {
ami = "${atlas_artifact.web.metadata_full.region-us-east-1}"
2014-12-08 03:42:27 +01:00
...
}
```
## 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.
2015-04-21 23:39:22 +02:00
* `build` - (Optional) The build number responsible for creating
the version of the artifact to filter on. This can be "latest",
2014-12-09 02:13:42 +01:00
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
2016-05-24 20:30:51 +02:00
to "latest". Cannot be specified with `version`. Note: `build` is only
present if Atlas builds the image.
2014-12-09 02:13:42 +01:00
2015-04-21 23:39:22 +02:00
* `version` - (Optional) The version of the artifact to filter on. This can
be "latest", to match against the latest version, "any" to find a matching artifact
2014-12-09 02:13:42 +01:00
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 hyphen.
2014-12-09 04:49:23 +01:00
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