Aws Machine Image Datasource¶
Table of values¶
Name | Value | Notes |
---|---|---|
Identifier | aws-machine-image |
|
Default versioning | aws-machine-image |
|
Custom registry support | Yes | |
Release timestamp support | Yes | The release timestamp is determined from the CreationDate field in the results. |
Source URL support | No |
Description¶
Warning
This datasource is experimental. Its syntax and behavior may change at any time!
This datasource returns the latest Amazon Machine Image via the AWS API.
Because the datasource uses the AWS-SDK for JavaScript, you can configure it like other AWS Tools. You can use common AWS configuration options, for example (partial list):
- Setting the region via
AWS_REGION
(environment variable) or your~/.aws/config
file - Provide credentials via
AWS_ACCESS_KEY_ID
andAWS_SECRET_ACCESS_KEY
(environment variable) or your~/.aws/credentials
file - Select the profile to use via
AWS_PROFILE
environment variable
Read the Developer guide for more information on configuration options.
The least IAM privileges required for this datasource are:
{
"Sid": "AllowEc2ImageLookup",
"Effect": "Allow",
"Action": ["ec2:DescribeImages"],
"Resource": "*"
}
Read the AWS IAM Reference for more information.
Because there is no general packageName
, you have to use the describe images filter as minified JSON as a packageName
.
Example:
# Getting the latest official EKS image from AWS (account '602401143452' for eu-central-1) for EKS 1.21 (name matches 'amazon-eks-node-1.21-*') would look as a describe images filter like:
[
{
"Name": "owner-id",
"Values": [ "602401143452" ]
},
{
"Name": "name",
"Values": [ "amazon-eks-node-1.21-*" ]
}
]
# In order to use it with this datasource, you have to minify it:
[{"Name":"owner-id","Values":["602401143452"]},{"Name":"name","Values":["amazon-eks-node-1.21-*"]}]
At the moment, this datasource has no "manager". You have to use the custom manager for this.
Usage Example
Here's an example of using the custom manager:
module.exports = {
customManagers: [
{
customType: 'regex',
managerFilePatterns: ['/.*/'],
matchStrings: [
'.*amiFilter=(?<packageName>.*?)\n(.*currentImageName=(?<currentDigest>.*?)\n)?(.*\n)?.*?(?<depName>[a-zA-Z0-9-_:]*)[ ]*?[:|=][ ]*?["|\']?(?<currentValue>ami-[a-z0-9]{17})["|\']?.*',
],
datasourceTemplate: 'aws-machine-image',
versioningTemplate: 'aws-machine-image',
},
],
};
Or as JSON:
{
'customManagers':
[
{
'customType': 'regex',
'managerFilePatterns': ['/.*/'],
'matchStrings':
[
".*amiFilter=(?<packageName>.*?)\n(.*currentImageName=(?<currentDigest>.*?)\n)?(.*\n)?.*?(?<depName>[a-zA-Z0-9-_:]*)[ ]*?[:|=][ ]*?[\"|']?(?<currentValue>ami-[a-z0-9]{17})[\"|']?.*",
],
'datasourceTemplate': 'aws-machine-image',
'versioningTemplate': 'aws-machine-image',
},
],
}
Note about currentImageName
:
The optional currentImageName
comment is automatically updated by Renovate to track the actual AMI name corresponding to the AMI ID.
This provides human-readable context about which image version is being used.
When Renovate finds a newer AMI, it will update both the AMI ID and the currentImageName
comment.
This would match every file, and would recognize the following lines:
# With AMI name mentioned in the comments
# amiFilter=[{"Name":"owner-id","Values":["602401143452"]},{"Name":"name","Values":["amazon-eks-node-1.21-*"]}]
# currentImageName=amazon-eks-node-1.21-v20240703
my_ami1: ami-02ce3d9008cab69cb
# Only AMI, no name mentioned
# amiFilter=[{"Name":"owner-id","Values":["602401143452"]},{"Name":"name","Values":["amazon-eks-node-1.20-*"]}]
# currentImageName=amazon-eks-node-1.20-v20240615
my_ami2: ami-0083e9407e275acf2
# Using custom aws profile and region
# amiFilter=[{"Name":"owner-id","Values":["602401143452"]},{"Name":"name","Values":["amazon-eks-node-1.20-*"]},{"profile":"test","region":"eu-central-1"}]
# currentImageName=amazon-eks-node-1.20-v20240615
ami = "ami-0083e9407e275acf2"
# Without currentImageName comment (also works!)
# amiFilter=[{"Name":"owner-id","Values":["602401143452"]},{"Name":"name","Values":["amazon-eks-node-1.19-*"]}]
my_ami3: ami-0a1b2c3d4e5f6g7h8
const myConfigObject = {
// With AMI name mentioned in the comments
// amiFilter=[{"Name":"owner-id","Values":["602401143452"]},{"Name":"name","Values":["amazon-eks-node-1.21-*"]}]
// currentImageName=amazon-eks-node-1.21-v20240703
my_ami1: 'ami-02ce3d9008cab69cb',
};
/**
* AMI with name tracked in comment
* amiFilter=[{"Name":"owner-id","Values":["602401143452"]},{"Name":"name","Values":["amazon-eks-node-1.20-*"]}]
* currentImageName=amazon-eks-node-1.20-v20240615
*/
const my_ami2 = 'ami-0083e9407e275acf2';
/**
* Without currentImageName comment
* amiFilter=[{"Name":"owner-id","Values":["602401143452"]},{"Name":"name","Values":["amazon-eks-node-1.19-*"]}]
*/
const my_ami3 = 'ami-0a1b2c3d4e5f6g7h8';
resource "aws_instance" "web" {
# AMI with name tracked in comment
# amiFilter=[{"Name":"owner-id","Values":["602401143452"]},{"Name":"name","Values":["amazon-eks-node-1.20-*"]}]
# currentImageName=amazon-eks-node-1.20-v20240615
ami = "ami-0083e9407e275acf2"
count = 2
source_dest_check = false
connection {
user = "root"
}
}
resource "aws_instance" "app" {
# Without currentImageName comment
# amiFilter=[{"Name":"owner-id","Values":["602401143452"]},{"Name":"name","Values":["amazon-eks-node-1.19-*"]}]
ami = "ami-0a1b2c3d4e5f6g7h8"
count = 1
}
Default configuration¶
{
"commitMessageExtra": "to {{{newVersion}}}",
"prBodyColumns": [
"Change",
"Image"
],
"prBodyDefinitions": {
"Image": "```{{{newDigest}}}```"
},
"digest": {
"commitMessageExtra": "to {{{newDigest}}}",
"prBodyColumns": [
"Image"
],
"prBodyDefinitions": {
"Image": "```{{{newDigest}}}```"
}
}
}