Add Cloud link to Azure topics #2713

londoncalling · 2017-04-10T19:29:30Z

What's changed

Adding topics on how to link Docker Cloud to Microsoft Azure Cloud Services, work-in-progress (WIP), still includes lots of TBD's

Topics to review

The relevant pages are on the Netlify preview are:

Reviewers

@KickingTheTV @MaximeHeckel @pkennedyr @jsouth

Signed-off-by: Victoria Bialas victoria.bialas@docker.com

londoncalling · 2017-04-12T06:26:48Z

Reviewers

@KickingTheTV @jsouth @MaximeHeckel @pkennedyr
Please take a look at the following updated docs pages on Netlify:

These are docs topics related to these Jira issues:

@mstanleyjones @johndmulhausen Please verify tabs implementation

Questions:

Where and at what point does the user need to add their SSH key?
I plan to add additional links, detail, and screen snaps to the first topic on Creating a Swarm. What else do you all think is needed to complete these topics for this week?

mdlinville

The tabs look and work great! Bravo!

I left a couple suggestions, including adding markdown=1 to each of the <div> tags which contains Markdown, so you don't have to use the capture/markdownify trick at all.

mdlinville · 2017-04-12T16:36:34Z

docker-cloud/cloud-swarm/link-azure-swarm.md

+### Check for existing SSH keys
+
+You may not need to generate a new SSH key if you have an existing key that you
+want to multi-purpose.


s/multi-purpose/reuse

mdlinville · 2017-04-12T16:37:56Z

_includes/content/ssh-add-keys-to-agent.md

+  <li><a data-toggle="tab" data-target="#linux-add-keys" data-group="linux">Linux</a></li>
+</ul>
+<div class="tab-content">
+<div id="mac-add-keys" class="tab-pane fade in active">


I think you may need to add markdown=1 to this div and any div whose contents contain Markdown. Then you don't need to do the capture and then display.

Tested this, but it didn't work as reliably as the current strategy:

{% capture some-label %} MARKDOWN CONTENT {% endcapture %} {{ some-label | markdownify }}

So leaving as is for now. NOT DOING THIS.

mdlinville · 2017-04-12T16:39:23Z

_includes/content/ssh-add-keys-to-agent.md

+    ```
+
+2.  On macOS Sierra 10.12.2 or newer, modify your
+`~/.ssh/config` file to automatically load keys into the `ssh-agent` and store


Indent these lines to line up with On

This looks lined up to me in source and on the rendered page. NOT DONE.

mdlinville · 2017-04-12T16:39:44Z

_includes/content/ssh-add-keys-to-agent.md

+
+3.  Add your SSH private key to the ssh-agent, using the default macOS `ssh-add` command.
+
+    ```none


Why not use the bash hint here?

Keeping same as GitHub instructions. Not sure what you mean. Feel free to update the file with a new PR later?

mdlinville · 2017-04-12T16:40:04Z

_includes/content/ssh-add-keys-to-agent.md

+{% capture mac-content-add %}
+1.  Start the `ssh-agent` in the background.
+
+    ```none


Which part of this does the user type and which is the response?

mdlinville · 2017-04-12T16:45:27Z

_includes/content/ssh-gen-keys.md

+2.  Paste the text below, substituting in your GitHub email address.
+
+    ```none
+    ssh-keygen -t rsa -b 4096 -C "your_email@example.com"


You might want to show the option to control the file name of the keys, so they are not just the default. The flag is -f. So you might do like -f docker-key

It's a good idea to have a key per area of concern, rather than one key for your whole life. This way if you need to rotate or revoke a key later, it is minimally disruptive.

Leaving for now. Feel free to update these files later with a new PR.

mdlinville · 2017-04-12T16:46:57Z

_includes/content/ssh-overview.md

@@ -0,0 +1,14 @@
+SSH is a secure protocol for accessing remote machines and applications. It


Should we add SSH to the glossary?

Yes. Will do later.

mdlinville · 2017-04-12T16:47:18Z

docker-cloud/cloud-swarm/create-cloud-swarm.md

-instances. The instances are then joined to a swarm and the swarm is configured
-using your input. When you access the swarm from Docker Cloud, the system
-forwards your commands directly to the Docker instances running in the swarm.
+When you create a swarm, Docker Cloud connects to the Cloud provider on your


does Cloud provider really need to be capitalized?

It's changing to service provider anyway. DONE.

mdlinville · 2017-04-12T16:48:04Z

docker-cloud/cloud-swarm/create-cloud-swarm.md


-## Create a swarm
+To create a swarm, you need to give Docker Cloud permission to deploy swarm
+nodes on your behalf in your cloud services provider account. Follw the steps in these topics depending on which Cloud provider you want to link:


nit: typo "follw"

mdlinville · 2017-04-12T16:50:48Z

docker-cloud/cloud-swarm/link-azure-swarm.md

+
+### Create a new SSH key
+
+{% include content/ssh-gen-keys.md %}


It occurs to me that having _includes/content/ doesn't really provide much organizational benefit. Maybe make a folder called _includes/ssh and use that for these topics? We probably need to come up with a sensible way to organize this stuff as we try to leverage reuse more.

Yup, I thought about that. For the short term, I started all these filenames with ssh- but a content specific subfolder would be better.

londoncalling · 2017-04-12T19:16:36Z

@KickingTheTV @pkennedyr FYI, here are notes from our quick chat this morning:

Re-work Swarm docs organization as follows, with separate topics:

Linking to Amazon Web Services
Linking to Azure Microsoft Azure
Create a Swarm in AWS
Create a Swarm in Azure
Setting up SSH keys

Add second-to-last step in "Linking to Azure" to grant Docker Cloud access permissions to Azure.
Change Cloud Providers to Service Providers
Add more screen snaps (AWS, Azure, Docker Cloud)
Vicky will test both procedures and all docs topics (Link to AWS, Create a swarm in AWS, Link to Azure, Create a swarm in Azure).
Docs to be published on Monday 4/17 (first day of DockerCon) along with feature release.

pkennedyr · 2017-04-12T21:39:01Z

Thanks, @londoncalling - the plan SGTM.

londoncalling · 2017-04-13T02:45:53Z

@KickingTheTV @pkennedyr

The topic reorganization is largely done: https://deploy-preview-2713--docker-docs.netlify.com/docker-cloud/cloud-swarm/.

There are separate topics for Linking Docker Cloud to AWS and Linking Docker Cloud to Azure
The SSH key information is in a stand-alone topic, and linked to from the "Linking Azure" topic

I still need to add screen snaps and flesh out the "create swarms" topics with specifics of each provider. Getting these topics completed is somewhat dependent on getting the linking working;
e.g., we hit an intermittent bug with linking to Azure
TBD notes are in red to make them stand out.
Links to videos per Ryan are on these pages, please check them out and let me know if they are what you want. We can do more of these as needed:

Also added ssh to glossary per @mstanleyjones comments, and noted limitations of autoredeploy to latest tagged images per user feedback.

pkennedyr · 2017-05-01T23:16:58Z

docker-cloud/cloud-swarm/create-cloud-swarm-aws.md

+    when using Docker for AWS. (To learn more, see
+    [Why Docker for AWS](/docker-for-aws/why.md).)
+
+> **Note**: At this time, you cannot add or remove nodes from a swarm from within Docker Cloud. To add new nodes or remove nodes from an existing swarm,


Since users will be able to remove nodes from a swarm via the Terminate option, let's remove the "remove nodes" references in this section.

pkennedyr · 2017-05-02T03:08:01Z

docker-cloud/cloud-swarm/create-cloud-swarm-aws.md

+    * Enable or disable Cloudwatch for container logging. (It is enabled by default.)
+
+    <font style="color:red;">
+    RYAN, ALBERTO:<br>


Believe the primary advantage of leaving "daily resource cleanup" enabled is to avoid incurring charges for resources that you are no longer using. (cc: @alberto for confirmation)

Btw, here's the AWS doc on the topic: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_CleaningUp.html

pkennedyr · 2017-05-02T03:09:57Z

docker-cloud/cloud-swarm/create-cloud-swarm-aws.md

+
+    ![](images/aws-create-swarm-6-manager-worker.png)
+
+    <font style="color:red;">RYAN, ALBERTO: Should we add more detail on machine sizes?</font>


Here is a link to the instance options and pricing on Azure: https://azure.microsoft.com/en-us/pricing/details/virtual-machines/linux/

Perhaps we could include a link.

WIP: 1st draft includes, tabs re: SSH key topics adding more Azure Cloud content and SSH includes copyedits cloud azure, aws topics organization, videos incorporated review comments copyedits, colour-coded TBD's copyedits to make create a swarm w/AWS and Azure consistent updated links to use new titles added SSH key setup to the Swarm overview list of links updated link services titles add ssh to glossary, note autoredeploy limitations Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

londoncalling · 2017-05-02T20:28:35Z

LGTM!

fermayo added the in progress label Apr 10, 2017

londoncalling added the area/cloud label Apr 12, 2017

mdlinville reviewed Apr 12, 2017

View reviewed changes

johndmulhausen removed the in progress label Apr 12, 2017

pkennedyr reviewed May 1, 2017

View reviewed changes

pkennedyr reviewed May 2, 2017

View reviewed changes

Victoria Bialas added 16 commits May 1, 2017 22:52

screen snaps, updates per latest on staging

063ce64

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

added link

7e45993

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

resolved conflicts in TOC

7a4c5cd

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

added Azure accept EULA/enable subscription, more steps, snaps

3d545fc

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

fixed the comments to not break numbering

67e2beb

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

new snaps and review comments incorporated from Alberto and Ryan

432f222

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

added screen snaps, review comments, more steps

6d057d1

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

added screen snaps, detail to Azure create swarm

a6f9028

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

new snap showing linked AWS as provider

d397f53

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

AWS screen snaps and detailed steps

516f12c

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

AWS swarm name rules clarification

9149e96

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

added x-refs to edition topics on config per reviews

94ea376

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

added connect screen snap w/production commands, AWS pricing

de360fd

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

added more code examples and clarification to swarm connect

6c6f72a

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

added more code examples for Azure and AWS

04a28da

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

londoncalling merged commit e552c02 into docker:master May 2, 2017

londoncalling deleted the cloud-docs branch May 3, 2017 20:51

londoncalling changed the title ~~WIP: add Cloud link to Azure topics~~ Add Cloud link to Azure topics May 3, 2017

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add Cloud link to Azure topics #2713

Add Cloud link to Azure topics #2713

londoncalling commented Apr 10, 2017 •

edited

Loading

londoncalling commented Apr 12, 2017 •

edited

Loading

mdlinville left a comment

mdlinville Apr 12, 2017

londoncalling Apr 13, 2017

mdlinville Apr 12, 2017

londoncalling Apr 12, 2017 •

edited

Loading

mdlinville Apr 12, 2017

londoncalling Apr 13, 2017

mdlinville Apr 12, 2017

londoncalling Apr 13, 2017

mdlinville Apr 12, 2017

londoncalling Apr 13, 2017

mdlinville Apr 12, 2017

londoncalling Apr 13, 2017

mdlinville Apr 12, 2017

londoncalling Apr 13, 2017

mdlinville Apr 12, 2017

londoncalling Apr 13, 2017 •

edited

Loading

mdlinville Apr 12, 2017

mdlinville Apr 12, 2017

londoncalling Apr 12, 2017

londoncalling Apr 12, 2017

londoncalling commented Apr 12, 2017 •

edited

Loading

pkennedyr commented Apr 12, 2017

londoncalling commented Apr 13, 2017 •

edited

Loading

pkennedyr May 1, 2017

pkennedyr May 2, 2017

pkennedyr May 2, 2017

londoncalling commented May 2, 2017


		3. Add your SSH private key to the ssh-agent, using the default macOS `ssh-add` command.

		```none

		@@ -0,0 +1,14 @@
		SSH is a secure protocol for accessing remote machines and applications. It


		### Create a new SSH key

		{% include content/ssh-gen-keys.md %}


		![](images/aws-create-swarm-6-manager-worker.png)

		<font style="color:red;">RYAN, ALBERTO: Should we add more detail on machine sizes?</font>

Add Cloud link to Azure topics #2713

Add Cloud link to Azure topics #2713

Conversation

londoncalling commented Apr 10, 2017 • edited Loading

What's changed

Topics to review

Reviewers

londoncalling commented Apr 12, 2017 • edited Loading

Reviewers

Questions:

mdlinville left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

londoncalling Apr 12, 2017 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

londoncalling Apr 13, 2017 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

londoncalling commented Apr 12, 2017 • edited Loading

pkennedyr commented Apr 12, 2017

londoncalling commented Apr 13, 2017 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

londoncalling commented May 2, 2017

londoncalling commented Apr 10, 2017 •

edited

Loading

londoncalling commented Apr 12, 2017 •

edited

Loading

londoncalling Apr 12, 2017 •

edited

Loading

londoncalling Apr 13, 2017 •

edited

Loading

londoncalling commented Apr 12, 2017 •

edited

Loading

londoncalling commented Apr 13, 2017 •

edited

Loading