OpenShift Route
Resumo
- Procura um serviço e cria uma nova rota com base nele.
Parâmetro
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
hostname | string | | Nome do host da rota. |
labels | dictionary | | Especifique os rótulos a serem aplicados ao conjunto Route. A criado de pares chave: valor. |
name | string | | Nome desejado da Rota a ser criada. Padrões para o valor do serviço |
namespace - required | string | | Namespace do recurso que está sendo direcionado. A rota também será criada neste namespace. |
path | string | | Caminho para a rota |
port | string | | Nome ou número da porta para a qual a Rota encaminhará o tráfego. |
service aliases: svc | string | | Nome do serviço a ser exposto.Required quando o estado não está ausente. |
termination | string | Escolhas: - edge - passthrough - reencrypt - insecure (default) | Tipo de terminação da Rota. Se deixado em branco, nenhum tipo de terminação será definido e a rota será insegura. Quando definido como inseguro, os tls serão ignorados. |
tls (Possíveis valores). | dictionary | | Configuração de TLS para a rota recém-criada. Usada somente quando termination é definido. |
wildcard_policy | string | Escolhas: - Subdomain | A política curinga para o nome do host. Atualmente, apenas o subdomínio é compatível. Se não for fornecido, o padrão None será usado. |
Subcampos da opção tls
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
ca_certificate | string | | Caminho para um arquivo de certificado CA no host de destino. Não suportado quando a terminação é definida como passthrough. |
certificate | string | | Caminho para um arquivo de certificado no host de destino. Não suportado quando o encerramento é definido como passthrough. |
destination_ca_certificate | string | | Caminho para um arquivo de certificado de CA usado para proteger a conexão. Usado somente quando a rescisão é definida para criptografar novamente. Padrões para CA de serviço. |
insecure_policy | string | Escolhas: - allow - redirect - disallow (default) | Define o InsecureEdgeTerminationPolicy para a rota. Não suportado quando a terminação é configurada para criptografar novamente. Quando a terminação é configurada como passthrough, apenas o redirecionamento é suportado. |
key | string | | Caminho para um arquivo de chave no host de destino. Não suportado quando a terminação é definida como passthrough. |
Extende fragmentos da documentação dos módulos k8s_auth_options, k8s_wait_options e k8s_state_options.
Exemplos
# Exemplo: Crie implantação hello-world
- k8s:
definition:
apiVersion: apps/v1
kind: Deployment
metadata:
name: hello-kubernetes
namespace: default
spec:
replicas: 3
selector:
matchLabels:
app: hello-kubernetes
template:
metadata:
labels:
app: hello-kubernetes
spec:
containers:
- name: hello-kubernetes
image: paulbouwer/hello-kubernetes:1.8
ports:
- containerPort: 8080
# Exemplo: Criar serviço para a implantação hello-world
- k8s:
definition:
apiVersion: v1
kind: Service
metadata:
name: hello-kubernetes
namespace: default
spec:
ports:
- port: 80
targetPort: 8080
selector:
app: hello-kubernetes
# Exemplo: Exponha o serviço inseguro hello-world externamente
- openshift_route:
service: hello-kubernetes
namespace: default
insecure_policy: allow
annotations:
haproxy.router.openshift.io/balance: roundrobin
register: route
Valores retornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
duration | integer | Quando wait é true | Tempo decorrido da tarefa em segundos. |
result (Possíveis valores). | complex | Sucesso | Objeto Route que foi criado ou atualizado. Estará vazio no caso de exclusão. |
Subcampos da chave de retorno result
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
apiVersion | string | Sucesso | Esquema com versão desta representação de um objeto. |
kind | string | Sucesso | Representa o recurso REST que este objeto representa. |
metadata (Possíveis valores). | complex | Sucesso | Metadados de objeto padrão. Inclui nome, namespace, anotações, rótulos, etc. |
spec (Possíveis valores). | complex | Sucesso | Especificação para a rota. |
status (Possíveis valores). | complex | Sucesso | Detalhes de status atual para a rota. |
Subcampos da chave de retorno metadata
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
name | string | Sucesso | Nome da rota criada. |
namespace | string | Sucesso | Namespace da rota de criação. |
Subcampos da chave de retorno spec
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
host | string | Sucesso | Host é um alias / DNS que aponta para o serviço. |
path | string | Sucesso | Caminho que o roteador procura, para rotear o tráfego para o serviço. |
port | complex | Sucesso | Define um mapeamento de porta de um roteador para um terminal nos terminais de serviço. |
tls | complex | Sucesso | Define a configuração usada para proteger uma rota e fornecer terminação. |
to | complex | Sucesso | Especifica o destino que resolve em nós de extremidade. |
wildcardPolicy | string | Sucesso | Política curinga, se houver, para a rota. |
Subcampos da chave de retorno status
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
ingress | complex | Sucesso | Lista de locais onde a rota pode ser exposta. |