Nastavení
Postavení load balanceru a endpoint service, vytvoření databázového uživatele a přijetí připojení Edmunda, s ukázkovými hodnotami u každého kroku.
Nastavení dělají jednou administrátoři AWS zákazníka v účtu, kde databáze běží. Potřebují v tomto účtu oprávnění pro Elastic Load Balancing, EC2 security groups a VPC endpoint services.
Každý krok uvádí místo v konzoli a příkazy AWS CLI. Příkazy na sebe navazují přes proměnné shellu, takže je lze spouštět popořadě v jedné terminálové relaci.
1. Hodnoty
Edmund se připojuje z účtu níže. Jde o hodnoty pro Shared Cloud Deployment (SaaS).
| Hodnota | Shared Cloud Deployment (SaaS) |
|---|---|
| AWS account ID Edmunda | 285021992921 |
| Region Edmunda | eu-west-1 |
| Allowed principal | arn:aws:iam::285021992921:root |
Jiné modely nasazení, například Private SaaS, se připojují z jiného účtu. Pro ně pošle Edmund své account ID a region před zahájením nastavení.
Databáze v jiném regionu než Edmund? Pokud region databáze není region Edmunda
(eu-west-1 pro Shared Cloud Deployment (SaaS)), jde o připojení mezi regiony
(cross-Region). AWS pak vyžaduje čtyři věci:
- Network Load Balancer je zapnutý nejméně ve dvou Availability Zones (AZ). Samotná databáze může zůstat v jedné AZ; zapněte cross-zone load balancing (krok 3).
- Region Edmunda je přidaný do Supported Regions endpoint service (krok 5).
- Load balancer ponechává výchozí TCP idle timeout (krok 3).
- Ten, kdo endpoint service vytváří, má oprávnění
vpce:AllowMultiRegion(krok 5).
Několik Availability Zones mimo Evropu cross-Region přístup nepodporuje; porovnejte AZ ID svých subnetů se seznamem na stránce AWS níže.
Viz Cross-Region access v dokumentaci AWS.
Příklady pro vaši stranu používají hodnoty níže. Nahraďte je svými.
444455556666 je ukázkové account ID z dokumentace AWS.
| Hodnota | Příklad |
|---|---|
| Vaše AWS account ID | 444455556666 |
| Region databáze | eu-west-1 |
| VPC databáze | vpc-0a1b2c3d4e5f67890 |
| Subnety pro load balancer | subnet-0aa11bb22cc33dd44, subnet-0ee55ff66aa77bb88 |
| Databáze | Amazon RDS for PostgreSQL, plant-db.c1a2b3c4d5e6.eu-west-1.rds.amazonaws.com |
| Privátní IP a port databáze | 10.20.1.25, 5432 |
| Security group databáze | sg-0d1b2c3d4e5f60718 |
| Název databáze a schéma | plant, maintenance |
Nastavte je jednou:
export AWS_REGION=eu-west-1
EDMUND_ACCOUNT=285021992921
EDMUND_REGION=eu-west-1
VPC_ID=vpc-0a1b2c3d4e5f67890
SUBNETS="subnet-0aa11bb22cc33dd44 subnet-0ee55ff66aa77bb88"
DB_IP=10.20.1.25
DB_PORT=5432
DB_SG=sg-0d1b2c3d4e5f60718
Privátní IP databáze RDS je adresa, na kterou se překládá její endpoint:
dig +short plant-db.c1a2b3c4d5e6.eu-west-1.rds.amazonaws.com
2. Vytvořte target group pro databázi
Target group říká load balanceru, kde databáze je. V konzoli: EC2 → Target Groups → Create target group, target type IP addresses, protocol TCP.
TG_ARN=$(aws elbv2 create-target-group \
--name edmund-db \
--protocol TCP --port "$DB_PORT" \
--target-type ip \
--vpc-id "$VPC_ID" \
--query 'TargetGroups[0].TargetGroupArn' --output text)
aws elbv2 register-targets \
--target-group-arn "$TG_ARN" \
--targets Id="$DB_IP",Port="$DB_PORT"
RDS a Aurora mohou po failoveru nebo údržbě změnit IP adresu. Target group si ponechá starou adresu a Edmund se nepřipojí, dokud se neaktualizuje. Udržujte target aktuální pomocí automatické aktualizace targetu od AWS, nebo dejte před databázi RDS Proxy a jako target použijte jeho adresy.
3. Vytvořte interní Network Load Balancer
V konzoli: EC2 → Load Balancers → Create load balancer → Network Load Balancer, scheme Internal, VPC databáze a listener na portu databáze přesměrovaný na target group.
Load balancer dostane vlastní security group, aby na ni mohl firewall databáze v dalším kroku odkazovat.
Endpoint Edmunda pro Shared Cloud Deployment (SaaS) používá všechny tři
Availability Zones (AZ) regionu eu-west-1, takže pokud je databáze také
v eu-west-1, funguje libovolná AZ. Pro dostupnost se přesto doporučují dvě AZ.
U jiných modelů nasazení Edmund své AZ potvrdí před zahájením nastavení, podle AZ
ID, protože názvy zón se mezi účty AWS liší. Pokud je databáze v jiném regionu,
musí $SUBNETS obsahovat subnety nejméně ve dvou AZ. TCP idle timeout ponechte
na výchozí hodnotě.
LB_SG=$(aws ec2 create-security-group \
--group-name edmund-db-nlb \
--description "Edmund PrivateLink load balancer" \
--vpc-id "$VPC_ID" \
--query GroupId --output text)
LB_ARN=$(aws elbv2 create-load-balancer \
--name edmund-db \
--type network \
--scheme internal \
--subnets $SUBNETS \
--security-groups "$LB_SG" \
--query 'LoadBalancers[0].LoadBalancerArn' --output text)
aws elbv2 create-listener \
--load-balancer-arn "$LB_ARN" \
--protocol TCP --port "$DB_PORT" \
--default-actions Type=forward,TargetGroupArn="$TG_ARN"
Pokud má load balancer zónu, ve které databáze není, zapněte cross-zone load balancing, aby uzel load balanceru v této zóně mohl předávat spojení databázi. U připojení mezi regiony s databází v jedné AZ to platí vždy. Při zapnutém cross-zone load balancingu účtuje AWS přenos dat mezi AZ. V konzoli: záložka Attributes load balanceru → Edit → Cross-zone load balancing.
aws elbv2 modify-load-balancer-attributes \
--load-balancer-arn "$LB_ARN" \
--attributes Key=load_balancing.cross_zone.enabled,Value=true
Vypněte vynucování inbound pravidel pro provoz PrivateLink. Přístup řídí endpoint service v kroku 5; se zapnutým vynucováním load balancer spojení Edmunda zahazuje. V konzoli: záložka Security load balanceru → Edit → zrušte zaškrtnutí Enforce inbound rules on PrivateLink traffic.
aws elbv2 set-security-groups \
--load-balancer-arn "$LB_ARN" \
--security-groups "$LB_SG" \
--enforce-security-group-inbound-rules-on-private-link-traffic off
4. Pusťte load balancer přes firewall databáze
Přidejte do security group databáze jedno inbound pravidlo: TCP na portu databáze ze security group load balanceru.
aws ec2 authorize-security-group-ingress \
--group-id "$DB_SG" \
--protocol tcp --port "$DB_PORT" \
--source-group "$LB_SG"
Ověřte stav targetu:
aws elbv2 describe-target-health \
--target-group-arn "$TG_ARN" \
--query 'TargetHealthDescriptions[0].TargetHealth.State' --output text
Během několika minut je výstup healthy.
5. Vytvořte endpoint service a povolte Edmunda
V konzoli: VPC → Endpoint services → Create endpoint service, load balancer type Network, Acceptance required zapnuto. Poté Allow principals u nové služby.
Pokud je databáze v jiném regionu než Edmund, přidejte k příkazu pro vytvoření níže
--supported-regions "$EDMUND_REGION". Ten, kdo jej spouští, potřebuje oprávnění
IAM vpce:AllowMultiRegion. V konzoli vyberte region Edmunda v poli Service
Regions ve formuláři pro vytvoření.
Pokud endpoint service pro tuto databázi už existuje, příkaz
create-vpc-endpoint-service-configuration přeskočte a SVC_ID nastavte na
existující službu, například SVC_ID=vpce-svc-0123456789abcdef0. Poté spusťte
zbývající příkazy bloku: povolení principalu a výpis názvu služby. Pokud je
databáze v jiném regionu než Edmund, nejprve službu připravte podle poznámky na
konci tohoto kroku.
SVC_ID=$(aws ec2 create-vpc-endpoint-service-configuration \
--network-load-balancer-arns "$LB_ARN" \
--acceptance-required \
--query 'ServiceConfiguration.ServiceId' --output text)
aws ec2 modify-vpc-endpoint-service-permissions \
--service-id "$SVC_ID" \
--add-allowed-principals "arn:aws:iam::${EDMUND_ACCOUNT}:root"
aws ec2 describe-vpc-endpoint-service-configurations \
--service-ids "$SVC_ID" \
--query 'ServiceConfigurations[0].ServiceName' --output text
Poslední příkaz vypíše název služby, například
com.amazonaws.vpce.eu-west-1.vpce-svc-0123456789abcdef0.
U už existující endpoint service v jiném regionu než Edmund postupujte v tomto pořadí:
-
Nastavte
LB_ARNna ARN existujícího load balanceru této služby:LB_ARN=arn:aws:elasticloadbalancing:eu-west-1:444455556666:loadbalancer/net/edmund-db/0123456789abcdef -
Ověřte, že load balancer používá výchozí TCP idle timeout. Cross-Region přístup vlastní hodnotu nepodporuje.
-
Pokud je load balancer jen v jedné AZ, přidejte do něj subnet ve druhé AZ.
set-subnetsseznam subnetů nahrazuje, uveďte proto všechny subnety, stávající i nový:aws elbv2 set-subnets \ --load-balancer-arn "$LB_ARN" \ --subnets subnet-0aa11bb22cc33dd44 subnet-0ee55ff66aa77bb88Pokud databáze zůstává v jedné AZ, zapněte také cross-zone load balancing (krok 3). Stávající target group jej nesmí vypínat: její atribut
load_balancing.cross_zone.enabledmusí býtuse_load_balancer_configuration(výchozí) nebotrue.Nová AZ se pro endpoint service nezapne automaticky. Počkejte několik minut, až je nová AZ load balanceru připravená, a pak ji zapněte. V konzoli: vyberte endpoint service → Actions → Associate or disassociate load balancers → Save changes.
aws ec2 modify-vpc-endpoint-service-configuration --service-id "$SVC_ID"Zkontrolujte, že jsou obě AZ uvedené na záložce Details endpoint service.
-
Teprve poté přidejte region Edmunda. Ten, kdo to dělá, potřebuje také oprávnění IAM
vpce:AllowMultiRegion.aws ec2 modify-vpc-endpoint-service-configuration \ --service-id "$SVC_ID" \ --add-supported-regions "$EDMUND_REGION"Region samotné endpoint service uvádět nemusíte, je podporovaný vždy. V konzoli: vyberte endpoint service → Actions → Modify supported Regions. Viz Cross-Region access v dokumentaci AWS.
6. Vytvořte databázového uživatele jen pro čtení
Edmund pouze čte. Pro PostgreSQL jako vlastník schématu:
CREATE ROLE edmund_readonly LOGIN PASSWORD 'choose-a-strong-password';
GRANT CONNECT ON DATABASE plant TO edmund_readonly;
GRANT USAGE ON SCHEMA maintenance TO edmund_readonly;
GRANT SELECT ON ALL TABLES IN SCHEMA maintenance TO edmund_readonly;
Další databázové systémy pokrývají specifika jednotlivých databází.
7. Pošlete hodnoty Edmundovi
Pět hodnot. Heslo se posílá zvlášť, kanálem dohodnutým s vaším kontaktem v Edmundovi, nikdy ne ve stejné zprávě jako ostatní.
| Hodnota | Příklad |
|---|---|
| Service name | com.amazonaws.vpce.eu-west-1.vpce-svc-0123456789abcdef0 |
| Region | eu-west-1 |
| Typ a port databáze | PostgreSQL, 5432 |
| Název databáze a schéma | plant, maintenance |
| Uživatel | edmund_readonly |
8. Přijměte žádost Edmunda o připojení
Edmund vytvoří svůj interface endpoint, který se na vaší endpoint service objeví jako čekající připojení. V konzoli: záložka Endpoint connections u endpoint service → Actions → Accept endpoint connection request.
Před přijetím zkontrolujte, že vlastníkem je účet Edmunda:
aws ec2 describe-vpc-endpoint-connections \
--filters Name=service-id,Values="$SVC_ID" \
--query 'VpcEndpointConnections[].[VpcEndpointId,VpcEndpointOwner,VpcEndpointState]' \
--output text
vpce-0fedcba9876543210 285021992921 pendingAcceptance
aws ec2 accept-vpc-endpoint-connections \
--service-id "$SVC_ID" \
--vpc-endpoint-ids vpce-0fedcba9876543210
Stav se změní na available.
9. Test připojení
Edmund se připojí jako edmund_readonly, ověří, že je vidět schéma a jeho tabulky,
a spustí testovací dotaz. Výsledek potvrdí vašemu kontaktu. V logech databáze
přicházejí spojení z privátních adres load balanceru.
Odebrání přístupu
Odmítnutí připojení Edmunda okamžitě odpojí. Odebrání principalu zabrání nové žádosti.
aws ec2 reject-vpc-endpoint-connections \
--service-id "$SVC_ID" \
--vpc-endpoint-ids vpce-0fedcba9876543210
aws ec2 modify-vpc-endpoint-service-permissions \
--service-id "$SVC_ID" \
--remove-allowed-principals "arn:aws:iam::${EDMUND_ACCOUNT}:root"