INTEGRITY Dokumentace

Správa fondů

V rámci Cloudflare pooly reprezentují vaše koncové body a způsob jejich organizace. Pool tak může být skupinou několika koncových bodů, nebo můžete mít v jednom poolu i jen jeden koncový bod (například origin server).

Pokud znáte terminologii DNS, představte si pool jako „sadu záznamů“, s tím rozdílem, že Cloudflare vrací pouze adresy, které jsou považovány za funkční. K jednotlivým poolům lze pro vlastní monitorování připojit monitory stavu. Pool může mít připojený buď jeden monitor, nebo skupinu monitorů, nikdy obojí zároveň.

Další podrobné informace o poolech najdete v Fondy.


Jedinečnost adres endpointů

V rámci jednoho poolu musí být každý endpoint jedinečný. Endpointy mohou sdílet stejnou IP adresu, pokud se liší portem nebo virtuální síť což je běžný vzor pro privátní endpointy dostupné na stejné IP adrese v různých interních sítích.


Vytvořit Pool

Pool můžete vytvořit v pracovní postup load balanceru nebo v Fondy kartě:

  1. Přejděte na Load Balancing.

  2. Vyberte Fondy kartu a poté Vytvoření poolu.

  3. Pro svůj pool zadejte následující informace:

    • Název (musí být jedinečný)
    • Popis, který název dále upřesňuje
    • Volba pro Směrování koncových bodů, což ovlivňuje způsob, jakým váš pool směruje provoz na jednotlivé koncové body
  4. Pro každý endpoint zadejte následující informace:

    • Název (musí být jedinečný)
    • Adresa endpointu nebo přidružený hostname
    • (Volitelné) Virtuální síť. Povinné, pokud má koncový bod privátní IP adresu.
    • A Váha
    • (Volitelné) název hostitele kliknutím na Přidejte hlavičku Host
    • (Volitelné) Cílový port, na který bude provoz obsluhován.
  1. Tento postup zopakujte pro další koncové body v poolu.

  2. (Volitelné) Nastavte souřadnice pro Proximity Steering na poolu.

  3. U poolu aktualizujte následující údaje:

    • Práh stavu:

      Health Threshold udává počet endpointů ve stavu healthy, které musí pool jako celek mít, aby byl považován za Funkční a přijímat provoz podle pořadí poolu v load balanceru. Zvýšením tohoto čísla se pool stává spolehlivějším, zároveň se ale zvyšuje pravděpodobnost, že se stane nezdravým.

    • Sledovat: Připojte monitor
    • Regiony monitoru stavu: Zvolte, zda se má stav poolu kontrolovat z více lokalit, což zvyšuje přesnost, ale může vést k sondovacímu provozu na váš koncový bod
    • Oznámení pro pool: Můžete si nastavit nové výstrahy (a zobrazit stávající), abyste byli upozorněni, když se pooly povolí nebo zakážou, nebo když se u poolů či endpointů změní jejich stav funkčnosti.
  4. Až budete hotovi, vyberte Save.

Úplný seznam vlastností najdete v Vytvoření poolu. Pokud potřebujete pomoc s ověřováním API, viz Dokumentace Cloudflare API.

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Load Balancing: Monitors and Pools Write
Vytvoření poolu
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/load_balancers/pools" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"description": "Primary data center - Provider XYZ",
		"name": "primary-dc-1",
		"enabled": false,
		"load_shedding": {
				"default_percent": 0,
				"default_policy": "random",
				"session_percent": 0,
				"session_policy": "hash"
		},
		"minimum_origins": 2,
		"monitor": "f1aba936b94213e5b8dca0c0dbf1f9cc",
		"check_regions": [
				"WEU",
				"ENAM"
		],
		"origins": [
				{
						"name": "app-server-1",
						"address": "0.0.0.0",
						"enabled": true,
						"weight": 0.56,
						"header": {
								"Host": [
										"example.com"
								]
						}
				}
		],
		"origin_steering": {
				"policy": "random"
		},
		"notification_filter": {
				"origin": {
						"disable": false,
						"healthy": null
				},
				"pool": {
						"disable": false,
						"healthy": null
				}
		}
	}'

Odpověď obsahuje úplnou definici nového poolu.

Odpověď
{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "id": "17b5962d775c646f3f9725cbc7a53df4",
    "created_on": "2021-01-01T05:20:00.12345Z",
    "modified_on": "2021-01-01T05:20:00.12345Z",
    "description": "Primary data center - Provider XYZ",
    "name": "primary-dc-1",
    "enabled": false,
    "load_shedding": {
      "default_percent": 0,
      "default_policy": "random",
      "session_percent": 0,
      "session_policy": "hash"
    },
    "minimum_origins": 2,
    "monitor": "f1aba936b94213e5b8dca0c0dbf1f9cc",
    "check_regions": [
      "WEU",
      "ENAM"
    ],
    "origins": [
      {
        "name": "app-server-1",
        "address": "0.0.0.0",
        "enabled": true,
        "weight": 0.56,
        "header": {
          "Host": [
            "example.com"
          ]
        }
      }
    ],
    "origin_steering": {
      "policy": "random"
    },
    "notification_filter": {
      "origin": {
        "disable": false,
        "healthy": null
      },
      "pool": {
        "disable": false,
        "healthy": null
      }
    }
  }
}

Po vytvoření poolu budete chtít také vytvořit nové oznámení s následujícími zadanými parametry:

"alert_type": "load_balancing_health_alert",
"filters": {
  "pool_id": <<ARRAY_OF_INCLUDED_POOL_IDS>>,
  "new_health": <<ARRAY_OF_STATUS_TRIGGERS>> ["Unhealthy", "Healthy"],
  "event_source": <<ARRAY_OF_OBJECTS_WATCHED>> ["pool", "origin"]
}

Úprava poolu

Úprava poolu v dashboardu:

  1. Přejděte na Load Balancing.
  2. Vyberte Fondy kartě.
  3. U konkrétního poolu vyberte Úprava.
  4. Podle potřeby aktualizujte nastavení.
  5. Vyberte Save.

Když upravujete pool pomocí API, typ požadavku závisí na tom, jak velký rozsah úprav chcete provést.

Chcete-li aktualizovat konkrétní nastavení, aniž byste museli znovu odesílat celou konfiguraci, použijte PATCH požadavek. Pro rozsáhlejší změny použijte PUT požadavek.


Odstranění poolu

Pooly, které používají load balancery, nelze odstranit. Platí to i pro regiony geografického směrování pooly, stejně jako záložní fondy.

Pokud se při pokusu o odstranění poolu zobrazí chyba, zkontrolujte hostname uvedené v chybě a upravit příslušné load balancery, nezapomeňte odstranit všechny odkazy na tento pool.

Odstranění poolu v dashboardu:

  1. Přejděte na Load Balancing.
  2. Vyberte Fondy kartě.
  3. U konkrétního poolu vyberte Smazat.

Pool odstraníte přes API odesláním požadavku DELETE požadavek.


Nastavte upozornění

Můžete nakonfigurovat upozornění, abyste dostávali oznámení o změnách stavu vašich poolů.

Aktivace poolu

Pro koho je určeno?

Zákazníci, kteří chtějí být upozorněni na změny stavu (enabled/disabled) svých poolů.

Další možnosti / filtry

Dostupné filtry:

Zahrnuto v

Nákup Load Balancing.

Co dělat, když upozornění obdržíte?

Není potřeba žádná akce.

Load Balancing Health Alert

Pro koho je určeno?

Zákazníci, kteří chtějí být upozorněni na změny stavu funkčnosti ve svých poolech nebo originech.

Další možnosti / filtry

Dostupné filtry:

Zahrnuto v

Nákup Load Balancing.

Co dělat, když upozornění obdržíte?

Vyhodnoťte analytika vyrovnávání zátěže ke sledování změn stavu v čase.

Viz Cloudflare Notifications pro další informace o nastavení upozornění.