.nh
.TH KUBERNETES(1) kubernetes User Manuals
Eric Paris
Jan 2015

.SH NAME
.PP
kubeadm certs generate-csr - Generate keys and certificate signing requests


.SH SYNOPSIS
.PP
\fBkubeadm certs generate-csr\fP [OPTIONS]


.SH DESCRIPTION
.PP
Generates keys and certificate signing requests (CSRs) for all the certificates required to run the control plane. This command also generates partial kubeconfig files with private key data in the  "users > user > client-key-data" field, and for each kubeconfig file an accompanying ".csr" file is created.

.PP
This command is designed for use in Kubeadm External CA Mode
\[la]https://kubernetes.io/docs/tasks/administer-cluster/kubeadm/kubeadm-certs/#external-ca-mode\[ra]\&. It generates CSRs which you can then submit to your external certificate authority for signing.

.PP
The PEM encoded signed certificates should then be saved alongside the key files, using ".crt" as the file extension, or in the case of kubeconfig files, the PEM encoded signed certificate should be base64 encoded and added to the kubeconfig file in the "users > user > client-certificate-data" field.


.SH OPTIONS
.PP
\fB--cert-dir\fP=""
	The path where to save the certificates

.PP
\fB--config\fP=""
	Path to a kubeadm configuration file.

.PP
\fB--kubeconfig-dir\fP="/etc/kubernetes"
	The path where to save the kubeconfig file.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
.PP
\fB--azure-container-registry-config\fP=""
	Path to the file containing Azure container registry configuration information.

.PP
\fB--rootfs\fP=""
	[EXPERIMENTAL] The path to the 'real' host root filesystem.

.PP
\fB--version\fP=false
	--version, --version=raw prints version information and quits; --version=vX.Y.Z... sets the reported version


.SH EXAMPLE
.PP
.RS

.nf
  # The following command will generate keys and CSRs for all control-plane certificates and kubeconfig files:
  kubeadm certs generate-csr --kubeconfig-dir /tmp/etc-k8s --cert-dir /tmp/etc-k8s/pki

.fi
.RE


.SH SEE ALSO
.PP
\fBkubeadm-certs(1)\fP,


.SH HISTORY
.PP
January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since!
