DocumentatieAEM as a Cloud ServiceHandboek

Het vormen van Verkeer bij CDN cdn-configuring-cloud

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder

AEM as a Cloud Service biedt een inzameling van eigenschappen aan configureerbaar bij de Adobe-geleide CDNlaag die de aard van of inkomende verzoeken of uitgaande reacties wijzigt. De volgende regels, die in detail in deze pagina worden beschreven, kunnen worden verklaard om het volgende gedrag te bereiken:

Ook configureerbaar bij CDN zijn de Regels van de Filter van het Verkeer (met inbegrip van WAF), die controleert welk verkeer door CDN wordt toegestaan of wordt ontkend. Deze eigenschap wordt reeds vrijgegeven en u kunt meer over het in de Regels van de Filter van het Verkeer met inbegrip van de pagina van de regels van WAFleren.

Bovendien, als CDN niet zijn oorsprong kan contacteren, kunt u een regel schrijven die verwijzingen een zelf-ontvangen pagina van de douanefout (die dan wordt teruggegeven). Leer meer over dit door te lezen Vormend CDN foutenpagina'sartikel.

Al deze regels, die in een configuratiedossier in broncontrole worden verklaard, worden opgesteld door de Pijpleiding van de Configuratie van Cloud Manager te gebruiken. Houd er rekening mee dat de cumulatieve grootte van het configuratiebestand, inclusief de regels voor verkeersfilters, niet groter kan zijn dan 100 kB.

Evaluatievolgorde order-of-evaluation

Functioneel worden de verschillende eerder vermelde functies in de volgende volgorde geëvalueerd:

afbeelding

Instellen initial-setup

Alvorens u verkeer bij CDN kunt vormen moet u het volgende doen:

  • Maak deze map en bestandsstructuur in de map op hoofdniveau van uw Git-project:
config/
     cdn.yaml

  • Het configuratiebestand van cdn.yaml moet zowel metagegevens als de regels bevatten die in de onderstaande voorbeelden worden beschreven. De parameter kind moet worden ingesteld op CDN en de versie moet worden ingesteld op de schemaversie, die momenteel 1 is.

  • Creeer een gerichte plaatsing config pijpleiding in Cloud Manager. Zie vormend productiepijpleidingenen vormend niet-productiepijpleidingen.

Nota's

  • RDEs steunt momenteel niet de configuratiepijplijn.
  • Met yq kunt u de YAML-opmaak van uw configuratiebestand lokaal valideren (bijvoorbeeld yq cdn.yaml ).

Syntaxis configuration-syntax

De regeltypen in de onderstaande secties hebben dezelfde syntaxis.

Een regel wordt van verwijzingen voorzien door een naam, een voorwaardelijk "wanneer clausule", en acties.

De clausule Wanneer bepaalt of een regel zal worden geëvalueerd, gebaseerd op eigenschappen zoals domein, weg, vraagkoorden, kopballen, en koekjes. De syntaxis is het zelfde over regeltypes; voor details, zie de 🔗 sectie van de Structuur van de Voorwaarde in het artikel van de Regels van de Filter van het Verkeer.

De details van het actieknooppunt verschillen per regeltype en worden in de afzonderlijke secties hieronder beschreven.

Transformaties aanvragen request-transformations

De de transformatieregels van het verzoek staan u toe om inkomende verzoeken te wijzigen. De regels ondersteunen het instellen, ongedaan maken en wijzigen van paden, queryparameters en headers (inclusief cookies) op basis van verschillende overeenkomende voorwaarden, waaronder reguliere expressies. U kunt ook variabelen instellen, waarnaar later in de evaluatiereeks kan worden verwezen.

Gebruiksscenario's zijn verschillend en bevatten URL-herschrijvingen voor het vereenvoudigen van toepassingen of het toewijzen van verouderde URL's.

Zoals eerder vermeld, is er een groottegrens aan het configuratiedossier zodat zouden de organisaties met grotere vereisten regels in de apache/dispatcher laag moeten bepalen.

Voorbeeld van configuratie:

kind: "CDN"
version: "1"
metadata:
  envTypes: ["dev", "stage", "prod"]
data:
  requestTransformations:
    removeMarketingParams: true
    rules:
      - name: set-header-rule
        when:
          reqProperty: path
          like: /set-header
        actions:
          - type: set
            reqHeader: x-some-header
            value: some value

      - name: unset-header-rule
        when:
          reqProperty: path
          like: /unset-header
        actions:
          - type: unset
            reqHeader: x-some-header

      - name: unset-matching-query-params-rule
        when:
          reqProperty: path
          equals: /unset-matching-query-params
        actions:
          - type: unset
            queryParamMatch: ^removeMe_.*$

      - name: unset-all-query-params-except-exact-two-rule
        when:
          reqProperty: path
          equals: /unset-all-query-params-except-exact-two
        actions:
          - type: unset
            queryParamMatch: ^(?!leaveMe$|leaveMeToo$).*$

      - name: multi-action
        when:
          reqProperty: path
          like: /multi-action
        actions:
          - type: set
            reqHeader: x-header1
            value: body set by transformation rule
          - type: set
            reqHeader: x-header2
            value: '201'

      - name: replace-html
        when:
          reqProperty: path
          like: /mypath
        actions:
          - type: transform
           reqProperty: path
           op: replace
           match: \.html$
           replacement: ""

Acties

In de onderstaande tabel worden de beschikbare acties beschreven.

Naam
Eigenschappen
Betekenis
plaats
(reqProperty of reqHeader of queryParam of reqCookie), value
Stelt een opgegeven aanvraagparameter (alleen eigenschap "path" ondersteund) of aanvraagheader, queryparameter of cookie in op een bepaalde waarde.
var, value
Stelt een opgegeven aanvraag-eigenschap in op een bepaalde waarde.
unset
reqProperty
Hiermee wordt een opgegeven aanvraagparameter (alleen eigenschap "path" ondersteund) of aanvraagheader, queryparameter of cookie naar een bepaalde waarde verwijderd.
var
Hiermee wordt een opgegeven variabele verwijderd.
queryParamMatch
Verwijdert alle queryparameters die overeenkomen met een opgegeven reguliere expressie.
transformatie
op:replace, (reqProperty of reqHeader of queryParam of reqCookie), match, replacement
Vervangt een deel van de aanvraagparameter (alleen eigenschap "path" wordt ondersteund) of verzoek header, query parameter of cookie door een nieuwe waarde.
op:tolower, (reqProperty of reqHeader of queryParam of reqCookie)
Stelt de parameter request (alleen eigenschap "path" wordt ondersteund), of aanvraagheader, queryparameter of cookie in op de waarde in kleine letters.

Handelingen kunnen aan elkaar worden gekoppeld. Bijvoorbeeld:

actions:
    - type: transform
      reqProperty: path
      op: replace
      match: \.html$
      replacement: ""
    - type: transform
      reqProperty: path
      op: tolower

Variabelen variables

U kunt variabelen tijdens de verzoektransformatie plaatsen en dan van verwijzingen voorzien hen later in de evaluatiereeks. Zie de orde van evaluatiediagram voor verdere details.

Voorbeeld van configuratie:

kind: "CDN"
version: "1"
metadata:
  envTypes: ["prod", "dev"]
data:
  requestTransformations:
    rules:
      - name: set-variable-rule
        when:
          reqProperty: path
          equals: /set-variable
        actions:
          - type: set
            var: some_var_name
            value: some_value

  responseTransformations:
    rules:
      - name: set-response-header-while-variable
        when:
          var: some_var_name
          equals: some_value
        actions:
          - type: set
            respHeader: x-some-header
            value: some header value

Responstransformaties response-transformations

De de transformatieregels van de Reactie staan u toe om kopballen van de uitgaande reacties van CDN te plaatsen en unset. Zie ook het bovenstaande voorbeeld voor het verwijzen naar een variabele die eerder is ingesteld in een aanvraagtransformatieregel.

Voorbeeld van configuratie:

kind: "CDN"
version: "1"
metadata:
  envTypes: ["prod", "dev"]
data:
  responseTransformations:
    rules:
      - name: set-response-header-rule
        when:
          reqProperty: path
          like: /set-response-header
        actions:
          - type: set
            value: value-set-by-resp-rule
            respHeader: x-resp-header

      - name: unset-response-header-rule
        when:
          reqProperty: path
          like: /unset-response-header
        actions:
          - type: unset
            respHeader: x-header1

      # Example: Multi-action on response header
      - name: multi-action-response-header-rule
        when:
          reqProperty: path
          like: /multi-action-response-header
        actions:
          - type: set
            respHeader: x-resp-header-1
            value: value-set-by-resp-rule-1
          - type: set
            respHeader: x-resp-header-2
            value: value-set-by-resp-rule-2

Acties

In de onderstaande tabel worden de beschikbare acties beschreven.

Naam
Eigenschappen
Betekenis
plaats
reqHeader, waarde
Stelt een opgegeven header in op een bepaalde waarde in de reactie.
unset
respHeader
Hiermee verwijdert u een opgegeven koptekst uit het antwoord.

Oorspronkelijke kiezers origin-selectors

U kunt hefboomwerking AEM CDN aan routeverkeer aan verschillende achtergronden, met inbegrip van toepassingen niet-Adobe (misschien op een per-weg of subdomain basis).

Voorbeeld van configuratie:

kind: "CDN"
version: "1"
metadata:
  envTypes: ["dev"]
data:
  originSelectors:
    rules:
      - name: example-com
        when: { reqProperty: path, like: /proxy-me* }
        action:
          type: selectOrigin
          originName: example-com
          # skpCache: true
    origins:
      - name: example-com
        domain: www.example.com
        # ip: '1.1.1.1'
        # forwardHost: true
        # forwardCookie: true
        # forwardAuthorization: true
        # timeout: 20

Acties

Uitleg in de onderstaande tabel is de beschikbare handeling.

Naam
Eigenschappen
Betekenis
selectOrigin
originName
Naam van een van de gedefinieerde oorsprong.
skipCache (optioneel, standaard is false)
Vlag of om caching voor verzoeken te gebruiken die deze regel aanpassen. De reacties worden standaard in de cache geplaatst op basis van de header voor het in cache plaatsen van reacties (bijvoorbeeld Cache-Control of Expires)

Oorsprong

Verbindingen met oorsprong zijn alleen SSL en gebruiken poort 443.

Eigenschap
Betekenis
naam
Naam waarnaar kan worden verwezen door "action.originName".
domein
Domeinnaam gebruikt om verbinding te maken met de aangepaste achtergrond. Het wordt ook gebruikt voor SSL SNI en bevestiging.
ip (facultatief, gesteund iv4 en ipv6)
Indien opgegeven, wordt deze gebruikt om verbinding te maken met de backend in plaats van met "domain". Stilstaand "domein" wordt gebruikt voor SSL SNI en validatie.
forwardHost (facultatief, gebrek is vals)
Indien ingesteld op true, wordt de header "Host" van de clientaanvraag doorgegeven aan de backend, anders wordt de waarde "domain" doorgegeven in de header "Host".
forwardCookie (facultatief, gebrek is vals)
Als de waarde true is, wordt de koptekst 'Cookie' uit de clientaanvraag doorgegeven aan de achterkant. Als dit niet het geval is, wordt de koptekst Cookie verwijderd.
forwardAuthorization (facultatief, gebrek is vals)
Als de waarde true is, wordt de header "Authorization" van de clientaanvraag doorgegeven aan de back-end, anders wordt de machtigingsheader verwijderd.
onderbreking (facultatief, in seconden, gebrek is 60)
Aantal seconden dat CDN op een backendserver moet wachten om de eerste byte van een HTTP-antwoordinstantie te leveren. Deze waarde wordt ook gebruikt als een tussenliggende time-out naar de backend-server.

Proxeren naar Edge Delivery Services proxying-to-edge-delivery

Er zijn scenario's waar de oorsprongsselecteurs zouden moeten worden gebruikt om verkeer door AEM Publish aan AEM Edge Delivery Services te leiden:

  • Sommige inhoud wordt geleverd door een domein dat wordt beheerd door AEM Publish, terwijl andere inhoud van hetzelfde domein door Edge Delivery Services wordt geleverd
  • De inhoud die door Edge Delivery Services wordt geleverd zou van regels profiteren die via de Pijpleiding van de Configuratie, met inbegrip van de regels van de verkeersfilter of verzoek/reactietransformaties worden opgesteld

Hier volgt een voorbeeld van een regel voor de oorspronkelijke kiezer waarmee u dit kunt bereiken:

kind: CDN
version: '1'
data:
  originSelectors:
    rules:
      - name: select-edge-delivery-services-origin
        when:
          allOf:
            - reqProperty: tier
              equals: publish
            - reqProperty: domain
              equals: <Production Host>
            - reqProperty: path
              matches: "^^(/scripts/.*|/styles/.*|/fonts/.*|/blocks/.*|/icons/.*|.*/media_.*|/favicon.ico)"
        action:
          type: selectOrigin
          originName: aem-live
    origins:
      - name: aem-live
        domain: main--repo--owner.aem.live
NOTE
Aangezien de Adobe Beheerde CDN wordt gebruikt, zorg ervoor om pushongeldigheid op beheerde wijze te vormen, door de Edge Delivery Services te volgen duw van de Opstelling de documentatie van de ongeldigverklaring.

Omleiding op de client client-side-redirectors

NOTE
Deze functie is nog niet algemeen beschikbaar. Als u wilt deelnemen aan het programma voor vroegtijdige adoptie, stuurt u een e-mail aemcs-cdn-config-adopter@adobe.com met een beschrijving van uw gebruiksscenario.

U kunt de omleidingsregels aan de clientzijde gebruiken voor 301, 302 en vergelijkbare omleidingen aan de clientzijde. Als een regel overeenkomt, reageert de CDN met een statusregel die de statuscode en het bericht bevat (bijvoorbeeld HTTP/1.1 301 Permanent verplaatst) en met de locatiekoptekenset.

Zowel absolute als relatieve locaties met vaste waarden zijn toegestaan.

Houd er rekening mee dat de cumulatieve grootte van het configuratiebestand, inclusief de regels voor verkeersfilters, niet groter kan zijn dan 100 kB.

Voorbeeld van configuratie:

kind: "CDN"
version: "1"
metadata:
  envTypes: ["dev"]
data:
  experimental_redirects:
    rules:
      - name: redirect-absolute
        when: { reqProperty: path, equals: "/page.html" }
        action:
          type: redirect
          status: 301
          location: https://example.com/page
      - name: redirect-relative
        when: { reqProperty: path, equals: "/anotherpage.html" }
        action:
          type: redirect
          location: /anotherpage
Naam
Eigenschappen
Betekenis
redirect
locatie
Waarde voor de koptekst 'Locatie'.
status (optioneel, standaard is 301)
De HTTP-status die standaard moet worden gebruikt in het omleidingsbericht, is 301. De toegestane waarden zijn: 301, 302, 303, 307, 308.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab