Ingress för inkommande förfrågningar

En tjänst utan internetåtkomst kan ändå skicka heartbeats till en övervakare för inkommande förfrågningar. Den skickar dem i stället till en anpassad sond i sitt eget nätverk, och sonden skickar dem vidare till Status200.

Så fungerar det#

1. Din tjänst skickar förfrågan till sonden. Samma GET eller POST, med samma hemliga nyckel, som den skulle skicka till Status200, till en port som sonden lyssnar på.
2. Sonden svarar direkt. Den svarar 200 innan den skickar förfrågan vidare, så din tjänst väntar aldrig på Status200.
3. Sonden skickar den vidare. Den skickar förfrågan vidare till Status200 med metod, huvuden och body, och lägger till ett huvud Status200-Probe-Id som anger sonden.
4. Status200 läser den som vanligt. Övervakarens kriterier ser förfrågan som om tjänsten hade skickat den direkt.

Lyssnaren körs på en egen port, skild från sondens hälsokontroller, så du kan öppna den mot ditt privata nätverk utan att öppna något annat.

När du använder den#

Använd lyssnaren när:

• Dina tjänster körs i ett isolerat nätverkssegment utan utgående HTTPS-åtkomst
• Du måste hålla all övervakningstrafik inom ditt VPC eller ditt lokala nätverk
• Du vill ha en enda utgångspunkt, sonden, som får nå Status200
• Du redan har driftsatt en anpassad sond och vill återanvända den för inkommande heartbeats

Om dina tjänster redan kan nå https://status200.ru (eller din självhostade URL) direkt behöver du inte den här funktionen: anropa heartbeat-URL:en direkt från tjänsten.

Innan du börjar#

• En anpassad sond som körs. Dess Status visar Ansluten. Se Anpassade probes för att installera en.
• En övervakare för inkommande förfrågningar. Dess heartbeat-URL innehåller den hemliga nyckel som din tjänst skickar: se Övervakning av inkommande förfrågningar.
• En port på sondens värd som dina tjänster kan nå. Exemplen använder 3875.

Slå på lyssnaren#

Sätt PROBE_INGRESS_PORT till porten som lyssnaren ska använda. Alla värden större än 0 slår på den; inte satt, eller 0, lämnar den avstängd.

docker run --name status200-probe --network host \
  -e PROBE_ID=<probe-id> \
  -e PROBE_KEY=<probe-key> \
  -e S200_URL=https://status200.ru \
  -e PROBE_INGRESS_PORT=3875 \
  -d registry.wilix.dev/status200/probe:latest

services:
  status200-probe:
    image: registry.wilix.dev/status200/probe:latest
    container_name: status200-probe
    environment:
      - PROBE_ID=<probe-id>
      - PROBE_KEY=<probe-key>
      - S200_URL=https://status200.ru
      - PROBE_INGRESS_PORT=3875
    network_mode: host
    restart: always

apiVersion: apps/v1
kind: Deployment
metadata:
  name: status200-probe
spec:
  selector:
    matchLabels:
      app: status200-probe
  template:
    metadata:
      labels:
        app: status200-probe
    spec:
      containers:
        - name: status200-probe
          image: registry.wilix.dev/status200/probe:latest
          env:
            - name: PROBE_ID
              value: "<probe-id>"
            - name: PROBE_KEY
              value: "<probe-key>"
            - name: S200_URL
              value: "https://status200.ru"
            - name: PROBE_INGRESS_PORT
              value: "3875"
          ports:
            - name: ingress
              containerPort: 3875
---
apiVersion: v1
kind: Service
metadata:
  name: status200-probe-ingress
spec:
  selector:
    app: status200-probe
  ports:
    - name: ingress
      port: 3875
      targetPort: 3875
  type: ClusterIP

När lyssnaren är igång står det i sondens logg Probe ingress listener started on port 3875 (heartbeat / incoming-request endpoints).

Skicka förfrågningar till sonden#

Din tjänst skickar till sonden i stället för till Status200. Ersätt den offentliga heartbeat-URL:en:

https://status200.ru/heartbeat/<secret-key>

med sondens ingress-URL:

http://<probe-host>:<PROBE_INGRESS_PORT>/heartbeat/<secret-key>

Sökväg, metod, body och huvuden är annars desamma, så befintlig klientkod behöver bara byta bas-URL. Sonden tar också emot /incoming-request/<secret-key>, som fungerar på samma sätt.

# GET heartbeat
curl http://probe.internal:3875/heartbeat/YOUR_SECRET_KEY

# POST heartbeat with JSON body
curl -X POST http://probe.internal:3875/heartbeat/YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{"status": "healthy", "version": "1.2.3"}'

# Cron job
*/5 * * * * curl -s http://probe.internal:3875/heartbeat/YOUR_SECRET_KEY > /dev/null

Så skickas förfrågningar vidare#

Miljövariabler#

Sondens vanliga variabler (PROBE_KEY, PROBE_ID, S200_URL och proxyvariablerna) gäller alla: se Anpassade probes för hela listan.

Säkerhetsöverväganden#

• Slutpunkten saknar autentisering med flit: den hemliga nyckeln i URL-sökvägen är autentiseringen, precis som på den offentliga slutpunkten status200.ru. Behandla den hemliga nyckeln som ett lösenord.
• Håll lyssnaren på ditt privata nätverk. Den ska inte kunna nås från internet. Använd en network policy, en brandväggsregel eller en ClusterIP-tjänst för att begränsa vem som kan nå den.
• Sätt TLS framför om du behöver kryptering på ditt nätverk. Lyssnaren talar vanlig HTTP. Placera den bakom en intern lastbalanserare eller ingress controller för att få TLS på den sträckan. Vidarebefordran från sonden till Status200 använder HTTPS när S200_URL börjar med https://.
• Begränsa body-storleken själv om 50 MB är för mycket. Placera en omvänd proxy med en lägre gräns framför lyssnaren.

Felsökning#

Nästa steg#