DNS
Some features and issues require DNS to be configured. The domain name jenkins-x.rocks
is available for
use. Jenkins X can either manage your DNS for you or you can manage the DNS manually. Read more about how
Jenkins X manages your DNS for you.
In both scenarios you can reuse the domain name if you delete the old cluster that was using it and create a new one. If you run both clusters at the same time you will need a domain name for each.
We cover both scenarios here as you may be debugging an issue that requires a particular setup - check the issue to find out what the user did! If you are unsure or it doesn’t seem relevant to the issue then the External DNS setup is easier to manage and we recommend you follow that.
With External DNS on Google Cloud Platform
To add records, visit the Google Cloud DNS dashboard for the jenkins-x-rocks project. If you need access please contact one of the project maintainers.
Once you have access, you can use the Add record set
button to add entries. External DNS will automatically update the
records if you reuse the domain name, so if you delete the old cluster and create a new one there is no need to go through
this process again.
- Choose a unique DNS name; you can use nested domains (e.g.
demo.example.pmuir.jenkins-x.rocks
). We recommend using<unique name>.<your username>.jenkins-x.rocks
so you can easily identify domains created by you. Enter this in theDNS Name
field using the format<unique name>.<your username>.jenkins-x-rocks.
(note that you can’t change the thejenkins-x.rocks
suffix and it is prefilled for you). - Run
jx create domain gke --domain <unique name>.<your username>.jenkins-x.rocks
. Make a note of the nameservers printed out. - Change the
Resource Record Type
toNS
) and use the default values forTTL
(5
) andTTL Unit
(minutes
). - Add the first nameserver to the
Name server
field - Click
Add item
and add the second nameserver. Do the same for rest of the nameservers - Click
Create
- Tell Jenkins X about the name.
- If you are using
jx install --external-dns
then paste<unique name>.<your username>.jenkins-x.rocks
into the prompt where you paused earlier - If you are using
jx boot
then editjx-requirements.yml
, and update thedomain
field (iningress
) to<unique name>.<your username>.jenkins-x.rocks
and runjx boot
Without External DNS on Google Cloud Platform
To add records, visit the Google Cloud DNS dashboard for the jenkins-x-rocks project. If you need access please contact one of the project maintainers.
Once you have access, you can use the Add record set
button to add entries or the pencil to edit entries.
- Choose a unique DNS name; you can use nested domains (e.g.
demo.example.pmuir.jenkins-x.rocks
). We recommend using<unique name>.<your username>.jenkins-x.rocks
so you can easily identify domains created by you. Enter this in theDNS Name
field using the format*.<unique name>.<your username>.jenkins-x-rocks.
(note that you can’t change the thejenkins-x.rocks
suffix and it is prefilled for you). - Find the cluster IP. The way to do this varies.
- If you used
jx install
then you must configure this during install. When you are prompted if you want to use the default.nip.io
domain copy the IP. You must now wait until your domain name is ready. - If you used jx boot then you can do this at any time. The domain name is present in the domain name and can be found
in
jx-requirements.yml
. Copy the IP.
- Use the default values for
Resource Record Type
(A
),TTL
(5
) andTTL Unit
(minutes
). - Paste the IP address you found above into the
IPv4 Address
field - Click
Create
- Check if the DNS has propagated to wherever you are running the
jx
command. Runwatch dig +short A test-dns.<unique name>.<your username>.jenkins-x.rocks
. Once the output changes to the IP address you found above the DNS has propagated. If you are using a Macwatch
can be installed usingbrew install watch
- Tell Jenkins X about the name.
- If you are using
jx install
then paste<unique name>.<your username>.jenkins-x.rocks
into the prompt where you paused earlier - If you are using
jx boot
then editjx-requirements.yml
, and update thedomain
field (iningress
) to<unique name>.<your username>.jenkins-x.rocks
and runjx boot
If you prefer to use the gcloud CLI you can find instructions for usage on the “Create record set” screen.
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.