--- apiVersion: v1 kind: List items: - apiVersion: v1 kind: ConfigMap metadata: labels: funktion.fabric8.io/kind: Connector provider: fabric8 project: connector-dns version: 1.1.23 group: io.fabric8.funktion.connector name: dns data: deployment.yml: | --- apiVersion: extensions/v1beta1 kind: Deployment metadata: labels: funktion.fabric8.io/kind: Subscription connector: dns spec: replicas: 1 template: metadata: labels: funktion.fabric8.io/kind: Subscription connector: dns spec: containers: - image: fabric8/connector-dns:1.1.23 name: connector schema.yml: | --- component: kind: component scheme: dns syntax: dns:dnsType title: DNS description: To lookup domain information and run DNS queries using DNSJava. label: networking deprecated: false async: false producerOnly: true javaType: org.apache.camel.component.dns.DnsComponent groupId: org.apache.camel artifactId: camel-dns version: 2.18.1 componentProperties: {} properties: dnsType: kind: path group: producer required: true type: string javaType: org.apache.camel.component.dns.DnsType enum: - dig - ip - lookup - wikipedia deprecated: false secret: false description: The type of the lookup. synchronous: kind: parameter group: advanced label: advanced type: boolean javaType: boolean deprecated: false secret: false defaultValue: false description: Sets whether synchronous processing should be strictly used or Camel is allowed to use asynchronous processing (if supported). documentation.adoc: |+ [[DNS-DNS]] DNS ~~~ *Available as of Camel 2.7* This is an additional component for Camel to run DNS queries, using DNSJava. The component is a thin layer on top of http://www.xbill.org/dnsjava/[DNSJava]. + The component offers the following operations: * ip, to resolve a domain by its ip * lookup, to lookup information about the domain * dig, to run DNS queries INFO:*Requires SUN JVM* The DNSJava library requires running on the SUN JVM. + If you use Apache ServiceMix or Apache Karaf, you'll need to adjust the `etc/jre.properties` file, to add `sun.net.spi.nameservice` to the list of Java platform packages exported. The server will need restarting before this change takes effect. Maven users will need to add the following dependency to their `pom.xml` for this component: [source,xml] ------------------------------------------------------------ org.apache.camel camel-dns x.x.x ------------------------------------------------------------ [[DNS-URIformat]] URI format ^^^^^^^^^^ The URI scheme for a DNS component is as follows [source,java] ------------------------- dns://operation[?options] ------------------------- This component only supports producers. [[DNS-Options]] Options ^^^^^^^ // component options: START The DNS component has no options. // component options: END // endpoint options: START The DNS component supports 2 endpoint options which are listed below: {% raw %} [width="100%",cols="2,1,1m,1m,5",options="header"] |======================================================================= | Name | Group | Default | Java Type | Description | dnsType | producer | | DnsType | *Required* The type of the lookup. | synchronous | advanced | false | boolean | Sets whether synchronous processing should be strictly used or Camel is allowed to use asynchronous processing (if supported). |======================================================================= {% endraw %} // endpoint options: END [[DNS-Headers]] Headers ^^^^^^^ [width="100%",cols="10%,10%,10%,70%",options="header",] |======================================================================= |Header |Type |Operations |Description |dns.domain |String |ip |The domain name. Mandatory. |dns.name |String |lookup |The name to lookup. Mandatory. |dns.type | | lookup, dig |The type of the lookup. Should match the values of `org.xbill.dns.Type`. Optional. |dns.class | | lookup, dig |The DNS class of the lookup. Should match the values of `org.xbill.dns.DClass`. Optional. |dns.query |String |dig |The query itself. Mandatory. |dns.server |String |dig |The server in particular for the query. If none is given, the default one specified by the OS will be used. Optional. |======================================================================= [[DNS-Examples]] Examples ^^^^^^^^ [[DNS-IPlookup]] IP lookup +++++++++ [source,xml] -------------------------------------- -------------------------------------- This looks up a domain's IP. For example, www.example.com resolves to 192.0.32.10. + The IP address to lookup must be provided in the header with key `"dns.domain"`. [[DNS-DNSlookup]] DNS lookup ++++++++++ [source,xml] -------------------------------------- -------------------------------------- This returns a set of DNS records associated with a domain. + The name to lookup must be provided in the header with key `"dns.name"`. [[DNS-DNSDig]] DNS Dig +++++++ Dig is a Unix command-line utility to run DNS queries. [source,xml] -------------------------------------- -------------------------------------- The query must be provided in the header with key `"dns.query"`. [[DNS-SeeAlso]] See Also ^^^^^^^^ * link:configuring-camel.html[Configuring Camel] * link:component.html[Component] * link:endpoint.html[Endpoint] * link:getting-started.html[Getting Started]