Configurar um servidor NTP externo

Nesta página, descrevemos como configurar um servidor NTP externo para o dispositivo isolado do Google Distributed Cloud (GDC).

Essas etapas são necessárias apenas se você quiser sincronizar o dispositivo com uma fonte de tempo externa.

Antes de começar

Para sincronizar o dispositivo com um servidor NTP externo, configure o dispositivo e instale o software.

Configurar o redirecionamento NTP

  1. Determine o endereço IP que o appliance isolado do GDC precisa usar para acessar seu servidor NTP. Talvez seja necessário ajustar as regras de firewall para permitir o tráfego.

  2. Usando o kubeconfig raiz, edite o CR ntprelay no cluster do plano de gerenciamento e adicione a seção upstreamServers.

    kubectl edit ntprelay bi-ntp-relay -n gpc-system
ntprelay.system.private.gdc.goog/bi-ntp-relay edited
kubectl get ntprelay bi-ntp-relay -n gpc-system -oyaml

    O YAML resultante tem uma seção .spec atualizada que inclui o IP, conforme mostrado no exemplo a seguir:

    apiVersion: system.private.gdc.goog/v1alpha1
kind: NTPRelay
metadata:
  creationTimestamp: "2025-05-16T08:44:21Z"
  generation: 2
  name: bi-ntp-relay
  namespace: gpc-system
  resourceVersion: "10871409"
  uid: 6cde8e65-791c-4bc6-9a8b-d5c9bf103f8b
spec:
  upstreamServers:
  - 192.0.2.030

  3. Verifique a hora em cada nó:

    Aguarde três minutos para dar tempo de sincronizar e execute o seguinte comando no cluster do plano de controle usando o kubeconfig raiz:

    kubectl get pods -l app.kubernetes.io/name=ntp -n ntp-system -o name | xargs -P 0 -I {} kubectl exec {} -n ntp-system -- date; echo

    A saída mostra a hora de cada nó, correspondendo à hora do seu servidor NTP. A saída será assim:

    Defaulted container "ntp-image" out of: ntp-image, ntp-node-exporter
Defaulted container "ntp-image" out of: ntp-image, ntp-node-exporter
Defaulted container "ntp-image" out of: ntp-image, ntp-node-exporter
Thu Nov  6 19:39:34 UTC 2025
Thu Nov  6 19:39:34 UTC 2025
Thu Nov  6 19:39:34 UTC 2025

Depurar problemas de conectividade

Se a hora não corresponder, execute o seguinte comando no cluster do plano de controle usando o kubeconfig raiz para depurar a conectividade com o servidor NTP:

kubectl get pods -l app.kubernetes.io/name=ntp -n ntp-system -o name | xargs -I {} kubectl exec {} -n ntp-system -- sh -c "chronyc sources -v; echo; chronyc ntpdata"; echo

A saída de uma conexão íntegra é semelhante a esta. O IP do servidor externo começa com ^*. Nos dados da origem (como Remote address : 192.0.2.026), TX é a quantidade de pacotes enviados, e RX é o número recebido. Se RX for 0, isso indica um problema de conectividade. Verifique se as solicitações de NTP estão passando pelo firewall:

  .-- Source mode  '^' = server, '=' = peer, '#' = local clock.
/ .- Source state '*' = current best, '+' = combined, '-' = not combined,
| /             'x' = may be in error, '~' = too variable, '?' = unusable.
||                                                 .- xxxx [ yyyy ] +/- zzzz
||      Reachability register (octal) -.           |  xxxx = adjusted offset,
||      Log2(Polling interval) --.      |          |  yyyy = measured offset,
||                                \     |          |  zzzz = estimated error.
||                                 |    |           \
MS Name/IP address         Stratum Poll Reach LastRx Last sample
===============================================================================
^* 192.0.2.026                   1   6    17    43   +286ns[  +36us] +/- 1160us
=? 192.0.2.029                 0   6     0     -     +0ns[   +0ns] +/-    0ns
=? 192.0.2.051                 0   6     0     -     +0ns[   +0ns] +/-    0ns
=? 192.0.2.059            0   6     0     -     +0ns[   +0ns] +/-    0ns

Remote address  : 192.0.2.026 (ACC03AF1)
Remote port     : 123
Local address   : 192.0.2.029 (0AA800D5)
Leap status     : Normal
Version         : 4
Mode            : Symmetric passive
Stratum         : 2
Poll interval   : 10 (1024 seconds)
Precision       : -25 (0.000000030 seconds)
Root delay      : 0.000381 seconds
Root dispersion : 0.000397 seconds
Reference ID    : ACC03BDF ()
Reference time  : Thu Nov 06 19:36:31 2025
Offset          : -0.000002443 seconds
Peer delay      : 0.000202604 seconds
Peer dispersion : 0.000000053 seconds
Response time   : 0.000097758 seconds
Jitter asymmetry: -0.37
NTP tests       : 111 111 1111
Interleaved     : No
Authenticated   : No
TX timestamping : Daemon
RX timestamping : Kernel
Total TX        : 67
Total RX        : 67
Total valid RX  : 67
Total good RX   : 67