Статия описва стъпките за автоматизация на управлението на SSL сертификати от използвайки и AWS.
— това е инструмент, който ще ни позволи да реализираме тази функция. Той работи с SSL сертификати от Let’s Encrypt, съхранява ги в Amazon Certificate Manager, използва Route53 API за реализиране на DNS-01 предизвикателство и, в крайна сметка, изпраща уведомления в SNS. В acme-dns-route53 също така присъства вградена функционалност за използване в AWS Lambda, и това е точно това, от което се нуждаем.
Тази статия е разделена на 4 части:
- създаване на zip файл;
- създаване на IAM роля;
- създаване на лябда функция, която стартира acme-dns-route53;
- създаване на CloudWatch таймер, който активира функцията 2 пъти на ден;
Забележка: преди да започнете, трябва да инсталирате и
Създаване на zip файл
acme-dns-route53 е написан на GoLang и поддържа версия не по-ниска от 1.9.
Трябва да създадем zip файл с бинарника acme-dns-route53 вътре. За целта е необходимо да инсталирате acme-dns-route53 от GitHub хранилище, използвайки командата go install:
$ env GOOS=linux GOARCH=amd64 go install github.com/begmaroman/acme-dns-route53Бинарникът е инсталиран в $GOPATH/bin директория. Обърнете внимание, че при инсталацията зададохме две променливи на средата: GOOS=linux и GOARCH=amd64. Те казват на Go компилатора, че трябва да създаде бинарник, подходящ за Linux OS и amd64 архитектура — това е, което се стартира в AWS.
AWS предполага разгръщане на нашата програма в zip файл, така че да създадем acme-dns-route53.zip архив, който ще съдържа току-що инсталирания бинарник:
$ zip -j ~/acme-dns-route53.zip $GOPATH/bin/acme-dns-route53Забележка: бинарникът трябва да бъде в корена на zip архива. За целта използваме -j флаг.
Сега нашият zip файл е готов за разгръщане, остава само да създадем роля с необходимите права.
Създаване на IAM роля
Трябва да настроим IAM роля с правата, необходими на нашата лябда по време на нейното изпълнение.
Нека наречем тази политика lambda-acme-dns-route53-executor и веднага да ѝ предоставим базовата роля AWSLambdaBasicExecutionRole. Това ще позволи на нашата лябда да стартира и да записва логове в AWS CloudWatch услугата.
Първо създаваме JSON файл, в който описваме нашите права. Това по същество ще позволи на лябда услугите да използват ролята lambda-acme-dns-route53-executor:
$ touch ~/lambda-acme-dns-route53-executor-policy.jsonСъдържанието на файла ни е следното:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:CreateLogGroup"
],
"Resource": "arn:aws:logs:::*"
},
{
"Effect": "Allow",
"Action": [
"logs:PutLogEvents",
"logs:CreateLogStream"
],
"Resource": "arn:aws:logs:::log-group:/aws/lambda/acme-dns-route53:*"
},
{
"Sid": "",
"Effect": "Allow",
"Action": [
"route53:ListHostedZones",
"cloudwatch:PutMetricData",
"acm:ImportCertificate",
"acm:ListCertificates"
],
"Resource": "*"
},
{
"Sid": "",
"Effect": "Allow",
"Action": [
"sns:Publish",
"route53:GetChange",
"route53:ChangeResourceRecordSets",
"acm:ImportCertificate",
"acm:DescribeCertificate"
],
"Resource": [
"arn:aws:sns:${var.region}::",
"arn:aws:route53:::hostedzone/*",
"arn:aws:route53:::change/*",
"arn:aws:acm:::certificate/*"
]
}
]
}Сега ще изпълним командата aws iam create-role за да създадем роля:
$ aws iam create-role --role-name lambda-acme-dns-route53-executor
--assume-role-policy-document ~/lambda-acme-dns-route53-executor-policy.jsonЗабележка: запомнете policy ARN (Amazon Resource Name) — той ни е необходим за следващите стъпки.
Ролята lambda-acme-dns-route53-executor е създадена, сега трябва да зададем разрешения за нея. Най-лесният начин да го направим е да използваме командата aws iam attach-role-policy, предавайки policy ARN AWSLambdaBasicExecutionRole по следния начин:
$ aws iam attach-role-policy --role-name lambda-acme-dns-route53-executor
--policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRoleЗабележка: списък с останалите политики можете да намерите .
Създаване на лямбда функция, която стартира acme-dns-route53
Ура! Сега можем да деплойваме нашата функция на AWS с помощта на командата aws lambda create-function. Лямбда трябва да бъде конфигурирана, използвайки следните променливи на средата:
AWS_LAMBDA— показва acme-dns-route53 че изпълнението се извършва в AWS Lambda.DOMAINS— списък на домейни, разделени с запетаи.LETSENCRYPT_EMAIL— съдържа .NOTIFICATION_TOPIC— название на SNS Notification Topic (по избор).STAGING— при значение1използва staging среда.1024MB — лимит на паметта, може да бъде променен.900secs (15 min) — таймаут.acme-dns-route53— името на нашия бинарник, който е в архива.fileb://~/acme-dns-route53.zip— пътят до архива, който създадохме.
Сега деплойваме:
$ aws lambda create-function
--function-name acme-dns-route53
--runtime go1.x
--role arn:aws:iam:::role/lambda-acme-dns-route53-executor
--environment Variables="{AWS_LAMBDA=1,DOMAINS="example1.com,example2.com",LETSENCRYPT_EMAIL=begmaroman@gmail.com,STAGING=0,NOTIFICATION_TOPIC=acme-dns-route53-obtained}"
--memory-size 1024
--timeout 900
--handler acme-dns-route53
--zip-file fileb://~/acme-dns-route53.zip
{
"FunctionName": "acme-dns-route53",
"LastModified": "2019-05-03T19:07:09.325+0000",
"RevisionId": "e3fadec9-2180-4bff-bb9a-999b1b71a558",
"MemorySize": 1024,
"Environment": {
"Variables": {
"DOMAINS": "example1.com,example2.com",
"STAGING": "1",
"LETSENCRYPT_EMAIL": "your@email.com",
"NOTIFICATION_TOPIC": "acme-dns-route53-obtained",
"AWS_LAMBDA": "1"
}
},
"Version": "$LATEST",
"Role": "arn:aws:iam:::role/lambda-acme-dns-route53-executor",
"Timeout": 900,
"Runtime": "go1.x",
"TracingConfig": {
"Mode": "PassThrough"
},
"CodeSha256": "+2KgE5mh5LGaOsni36pdmPP9O35wgZ6TbddspyaIXXw=",
"Description": "",
"CodeSize": 8456317,
"FunctionArn": "arn:aws:lambda:us-east-1::function:acme-dns-route53",
"Handler": "acme-dns-route53"
}Създаване на CloudWatch таймер, който задейства функцията два пъти на ден
Последната стъпка е да настроим cron, който да извиква нашата функция два пъти на ден:
- създайте правило в CloudWatch със стойност
schedule_expression. - създайте цел на правилото (какво да се изпълнява), като зададете ARN на lambda функцията.
- дозволете на правилото да извиква lambda функцията.
По-долу съм прикачил моя Terraform конфигурация, но всъщност това се прави много лесно чрез AWS конзолата или AWS CLI.
# Cloudwatch event rule that runs acme-dns-route53 lambda every 12 hours
resource "aws_cloudwatch_event_rule" "acme_dns_route53_sheduler" {
name = "acme-dns-route53-issuer-scheduler"
schedule_expression = "cron(0 */12 * * ? *)"
}
# Specify the lambda function to run
resource "aws_cloudwatch_event_target" "acme_dns_route53_sheduler_target" {
rule = "${aws_cloudwatch_event_rule.acme_dns_route53_sheduler.name}"
arn = "${aws_lambda_function.acme_dns_route53.arn}"
}
# Give CloudWatch permission to invoke the function
resource "aws_lambda_permission" "permission" {
action = "lambda:InvokeFunction"
function_name = "${aws_lambda_function.acme_dns_route53.function_name}"
principal = "events.amazonaws.com"
source_arn = "${aws_cloudwatch_event_rule.acme_dns_route53_sheduler.arn}"
}Сега и вие имате настроено автоматично създаване и обновление на SSL сертификати
Източник: habr.com
