Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

Onboarding: Sketch the Landscape

DZone's Guide to

Onboarding: Sketch the Landscape

· DevOps Zone
Free Resource

The Nexus Suite is uniquely architected for a DevOps native world and creates value early in the development pipeline, provides precise contextual controls at every phase, and accelerates DevOps innovation with automation you can trust. Read how in this ebook.

For four months during 2012 I was working on the GDS infrastructure team and one of the first tasks that Gareth suggested I do was update a diagram showing how all the different applications and databases worked together.

I thought this was quite a strange thing to ask the ‘new guy’ to do since I obviously knew nothing at all about how anything worked but he told me that was partly why he wanted me to do it.

I had to go through the puppet and application repositories to work out what monitoring we already had in place, which applications used MongoDB, which used MySQL, which called each other and so on.

If anything didn’t make sense I could go and ask someone in one of the application teams and then add my new understanding to the diagram.

As micro services driven architectures become more and more popular it strikes me that this probably wouldn’t be a bad starting point for anyone new to a system.

When you’re new you don’t yet have the familiarisation that makes things ‘obvious’ so you’re less likely to skip over things and more likely to be inquisitive about why things are the way they are.

As you come across things that don’t make sense others who have worked there for longer can play the role of the shaman who explains the history and context behind the decisions which have led to the current state.

Although diagrams can quickly go out of date I still think one of the whole landscape is useful as it gives everyone a common point of reference which can help reduce misunderstandings.

Pat Kua has a bunch of articles covering various different onboarding activities which are probably worth a read if this is your type of thing.

The DevOps Zone is brought to you in partnership with Sonatype Nexus.  See how the Nexus platform infuses precise open source component intelligence into the DevOps pipeline early, everywhere, and at scale. Read how in this ebook

Topics:

Published at DZone with permission of Mark Needham, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

THE DZONE NEWSLETTER

Dev Resources & Solutions Straight to Your Inbox

Thanks for subscribing!

Awesome! Check your inbox to verify your email so you can start receiving the latest in tech news and resources.

X

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}