OpenShift Route

9 min

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.