# Podのホスト名

LLMS index: [llms.txt](/llms.txt)

---

<!-- overview -->

このページでは、Podのホスト名を設定する方法、その設定後に起こり得る副作用、そして基盤となる仕組みについて説明します。

<!-- body -->

## Podのデフォルトのホスト名
Podが作成されると、(Pod内部から観測される)そのホスト名は、Podのmetadata.nameの値から導き出されます。
ホスト名と、それに対応する完全修飾ドメイン名(FQDN)の両方が(Podの視点からは)metadata.nameの値に設定されます。

```yaml
apiVersion: v1
kind: Pod
metadata:
  name: busybox-1
spec:
  containers:
  - image: busybox:1.28
    command:
      - sleep
      - "3600"
    name: busybox
```

このmanifestで作成されたPodは、ホスト名と完全修飾ドメイン名(FQDN)が`busybox-1`に設定されます。

## Podのhostnameとsubdomainフィールド
Podのspecには、オプションの`hostname`フィールドがあります。
この値が設定されると、Podの`metadata.name`よりも優先され、(Pod内部から観測される)ホスト名として使われます。
例えば、spec.hostnameが`my-host`に設定されているPodは、ホスト名が`my-host`です。

また、Podのspecにはオプションの`subdomain`フィールドもあり、Podが自分のNamespace内のサブドメインに属していることを示します。
もしPodの`spec.hostname`が"foo"、spec.subdomainが"bar"に設定され、さらにNamespaceが`my-namespace`の場合、ホスト名は`foo`で、完全修飾ドメイン名(FQDN)は(Podの内部から観測される)`foo.bar.my-namespace.svc.cluster-domain.example`です。

hostnameとsubdomainの両方が設定されていると、クラスターのDNSサーバーはこれらのフィールドに基づいてA/AAAAレコードを作成します。
[Podのhostnameとsubdomainフィールド](/docs/concepts/services-networking/dns-pod-service/#pod-hostname-and-subdomain-field)を参照してください。

## PodのsetHostnameAsFQDNフィールド








  <div class="feature-state-notice feature-stable">
      <span class="feature-state-name">FEATURE STATE:</span>
      <code>Kubernetes v1.22 [stable]</code>
    </div>
  



Podが完全修飾ドメイン名(FQDN)を持つように設定されている場合、そのホスト名は短いホスト名です。
例えば、Podの完全修飾ドメイン名が`busybox-1.busybox-subdomain.my-namespace.svc.cluster-domain.example`の場合、デフォルトではそのPod内で`hostname`コマンドを実行すると`busybox-1`が返り、`hostname --fqdn`コマンドを実行するとFQDNが返ります。

`setHostnameAsFQDN: true`とsubdomainフィールドがPodのspecに設定されている場合、kubeletはそのPodのNamespaceに対してFQDNをホスト名として書き込みます。
この場合、`hostname`と`hostname --fqdn`の両方がPodのFQDNを返します。

PodのFQDNは前述と同じ方法で構築されます。
つまり、Podの`spec.hostname`(設定されている場合)または`metadata.name`フィールド、`spec.subdomain`、`namespace`名、そしてクラスタードメインサフィックスで構成されます。


<div class="alert alert-info" role="note"><h4 class="alert-heading">備考:</h4><p>Linuxでは、kernelのhostnameフィールド(<code>struct utsname</code>の<code>nodename</code>フィールド)は64文字に制限されています。</p>
<p>Podがこの機能を有効にし、そのFQDNが64文字を超える場合、起動に失敗します。
そのPodは<code>Pending</code>ステータスのままになり(<code>kubectl</code>からは<code>ContainerCreating</code>と表示)、&quot;Failed to construct FQDN from Pod hostname and cluster domain&quot;などのエラーイベントが生成されます。</p>
<p>つまり、このフィールドを使う場合、Podの<code>metadata.name</code>(または<code>spec.hostname</code>)と<code>spec.subdomain</code>フィールドを組み合わせた長さが64文字を超えないようにする必要があります。</p>
</div>


## PodのhostnameOverride







  <div class="feature-state-notice feature-beta" title="フィーチャーゲート: HostnameOverride">
              <span class="feature-state-name">FEATURE STATE:</span> 
              <code>Kubernetes v1.35 [beta]</code>(デフォルトで有効)</div>


Podのspecで`hostnameOverride`に値を設定すると、kubeletは無条件にその値をPodのホスト名とFQDN両方に設定します。

`hostnameOverride`フィールドには64文字の長さ制限があり、[RFC 1123](https://datatracker.ietf.org/doc/html/rfc1123)で定義されているDNSのサブドメイン名の基準に従う必要があります。

例:
```yaml
apiVersion: v1
kind: Pod
metadata:
  name: busybox-2-busybox-example-domain
spec:
  hostnameOverride: busybox-2.busybox.example.domain
  containers:
  - image: busybox:1.28
    command:
      - sleep
      - "3600"
    name: busybox
```

<div class="alert alert-info" role="note"><h4 class="alert-heading">備考:</h4>これはPod内のホスト名にのみ影響し、クラスターのDNSサーバーにおけるPodのAレコードやAAAAレコードには影響しません。</div>


`hostnameOverride`が`hostname`や`subdomain`フィールドと同時に設定されている場合:
* Pod内のホスト名は`hostnameOverride`の値に上書きされます。

* クラスターのDNSサーバーにおけるPodのA/AAAAレコードは、`hostname`と`subdomain`フィールドに基づいて引き続き生成されます。

備考: `hostnameOverride`が設定されている場合、`hostNetwork`と`setHostnameAsFQDN`フィールドを同時に設定することはできません。
APIサーバーは、この組み合わせで作成要求が行われた場合、明示的に拒否します。

`hostnameOverride`が他のフィールド(hostname、subdomain、setHostnameAsFQDN、hostNetwork)と組み合わされた時の動作の詳細については、[KEP-4762の設計詳細](https://github.com/kubernetes/enhancements/blob/master/keps/sig-network/4762-allow-arbitrary-fqdn-as-pod-hostname/README.md#design-details)の表を参照してください。