Configurer votre proxy

Créez des proxy rules avec le proxy controller pour exposer votre Cargo.
Une proxy rule redirige une adresse IP et un port, ou un domaine, vers une cible en amont d’un Cargo.

Ajouter des règles de proxy

Pour suivre ce tutoriel, un Cargo nommé my-cargo doit fonctionner avec le port HTTP 9001 ouvert.

Créez proxy.deploy-example.yml et copiez le contenu suivant :


ApiVersion: v0.18

Resources:
- Name: deploy-example.com
  Kind: ncproxy.io/rule/v0.15
  Data:
    Rules:
      # Domain name for the target
    - Domain: deploy-example.com
      # See https://docs.next-hat.com/references/nanocl/objects/resource#proxy-rule-network
      # For more information about proxy rule network
      Network: All
      # List of target by path for maximum flexibility
      Locations:
      - Path: /
        Target:
          # Canonical target: `namespace.name.c` for a Cargo or `namespace.name.v` for a VM
          Key: global.my-cargo.c
          # Cargo port to target
          Port: 9001

Créons maintenant la règle de proxy avec :


nanocl state apply -s proxy.deploy-example.yml

Affichez les ressources existantes avec :


nanocl resource ls

Testons le bon fonctionnement de notre règle :


curl --header "Host: deploy-example.com" 127.0.0.1

La sortie attendue est :


{
  "headers": {
    "x-forwarded-proto": "http",
    "x-forwarded-for": "127.0.0.1",
    "accept": "*/*",
    "x-real-ip": "127.0.0.1",
    "connection": "close",
    "x-forwarded-scheme": "http",
    "host": "deploy-example.com",
    "user-agent": "curl/8.2.1"
  },
  "envs": {
    "   ": "/bin/nanocl-get-started",
    "NANOCL_CARGO_INSTANCE": "0",
    "NANOCL_NODE_ADDR": "192.168.8.102",
    "HOME": "/",
    "PATH": "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
    "TERM": "xterm",
    "PORT": "9001",
    "HOSTNAME": "global.my-cargo-r0-my-cargo-d4e5f6.c",
    "NANOCL_CARGO_KEY": "global.my-cargo",
    "NANOCL_CARGO_NAMESPACE": "global",
    "NANOCL_NODE": "behuman"
  }
}

Vous savez maintenant configurer une règle de proxy pour votre Cargo. Bons déploiements avec Nanocl !