Edmund AI Dokumentace
/NÁVODY

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).

HodnotaShared Cloud Deployment (SaaS)
AWS account ID Edmunda285021992921
Region Edmundaeu-west-1
Allowed principalarn:aws:iam::285021992921:root
Note

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í.

Warning

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:

  1. 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).
  2. Region Edmunda je přidaný do Supported Regions endpoint service (krok 5).
  3. Load balancer ponechává výchozí TCP idle timeout (krok 3).
  4. 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.

HodnotaPříklad
Vaše AWS account ID444455556666
Region databázeeu-west-1
VPC databázevpc-0a1b2c3d4e5f67890
Subnety pro load balancersubnet-0aa11bb22cc33dd44, subnet-0ee55ff66aa77bb88
DatabázeAmazon RDS for PostgreSQL, plant-db.c1a2b3c4d5e6.eu-west-1.rds.amazonaws.com
Privátní IP a port databáze10.20.1.25, 5432
Security group databázesg-0d1b2c3d4e5f60718
Název databáze a schémaplant, 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"
Warning

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
Success

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.

Note

U už existující endpoint service v jiném regionu než Edmund postupujte v tomto pořadí:

  1. Nastavte LB_ARN na ARN existujícího load balanceru této služby:

    LB_ARN=arn:aws:elasticloadbalancing:eu-west-1:444455556666:loadbalancer/net/edmund-db/0123456789abcdef
  2. Ověřte, že load balancer používá výchozí TCP idle timeout. Cross-Region přístup vlastní hodnotu nepodporuje.

  3. Pokud je load balancer jen v jedné AZ, přidejte do něj subnet ve druhé AZ. set-subnets seznam 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-0ee55ff66aa77bb88

    Pokud 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.enabled musí být use_load_balancer_configuration (výchozí) nebo true.

    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.

  4. 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

Success

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í.

HodnotaPříklad
Service namecom.amazonaws.vpce.eu-west-1.vpce-svc-0123456789abcdef0
Regioneu-west-1
Typ a port databázePostgreSQL, 5432
Název databáze a schémaplant, maintenance
Uživateledmund_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"