101-cognitive-services-translation

Add getting started guide

Author: leestott

101-cognitive-services-translate/GettingStarted.md

@@ -0,0 +1,128 @@
+# Cognitive services Translation Services
+
+The purpose of this ARM Template is **deploy a Cognitive Service Translate Service**.
+
+Let's understand a bit better how all this work.
+
+## Overview
+
+Azure Cognitive Services are APIs, SDKs, and services available to help developers build intelligent applications without having direct AI or data science skills or knowledge. Azure Cognitive Services enable developers to easily add cognitive features into their applications. The goal of Azure Cognitive Services is to help developers create applications that can see, hear, speak, understand, and even begin to reason. The catalog of services within Azure Cognitive Services can be categorized into five main pillars - Vision, Speech, Language, Web Search, and Decision.
+
+## Pre Deployment Steps
+
+Before processing to the deployment of the template, we need to perform the following steps.
+
+### The template
+
+Don't let the size of the template scares you. The structure is very intuitive and once that you get the gist of it, you will see how easier your life will be regarding deploying resources to Azure.
+
+Those are the parameters on the template. Some of them are already with the values, the ones that you need to inform are **cognitiveServiceName** and the **sku** in case that need a powerful service.
+
+Parameter         | Suggested value     | Description
+:--------------- |:-------------      |:---------------------
+**cognitiveServiceName** |*location*-*name*-*enviroment* i.e.:  uks-name-tst  | A globally unique name of azure cognitive services. I recommend you to use the notation above, that will help to create a unique name for your Cognitive Service. The name must use alphanumeric and underscore characters only. There is a 35 character limit to this field.
+**location**| The default location | Select the geographic location for your resource group.
+**Resource Group**| your resource group |  That is the Resource Group that you need to deploy your resources.
+**sku**| F0  |  Sku is an identifier for the product that we need. F0 is for the most basic characteristics.
+
+## Deployment
+
+There are a few ways to deploy this template.
+You can use [PowerShell](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-template-deploy), [Azure CLI](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-template-deploy-cli), [Azure Portal](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-template-deploy-portal) or your favorite SDK.
+
+For Azure CLI I'm using the Visual Code with Azure CLI extensions, if you like, you can find more information [here](https://code.visualstudio.com/docs/azure/extensions). But bare in mind that you don't need to use the Visual Code, you can stick with the old good always present **Command Line** on Windows or any **bash terminal**
+
+### Using Azure CLI with Visual Code
+
+Type on the terminal window: **az login**
+
+![Screen](./images/az-log.png)
+
+You will be redirected to the Azure Portal where you can insert your credentials and log in.
+
+After logged in, you will see your credentials on the terminal.
+
+To set the right subscription, type following command:
+
+#### az account set --subscription "your subscription id"
+
+### Resource Group
+
+Now you need a Resource Group for our deployment. If you haven't yet created a Resource Group, you can do it now. If you are new on Azure and wonder what is a Resource Group? Bare with me! A Resource Group is a container that holds related resources for an Azure solution. The resource group includes those resources that you want to manage as a group. Simply saying, it's like a folder that contains files. Simple as that.
+
+To create a Resource Group, you need a name and a location for your Resource Group.
+
+For a list of locations, type: **az account list-locations**
+
+To create the Resource group, type the command:
+
+#### az group create --name "resource-group" --location "your location"
+
+![Screen](./images/az-groupcreate.png)
+
+Super simple, right? Now that we have our **Resource Group** created, let's deploy the **Cognitive Service Translation**.
+
+![Screen](./images/az-group-deploy.png)
+
+Go grab a cup of coffee, have some fresh air. Before you come back you will have your Cognitive Service.
+
+Let's check the resource on the [Azure Portal](https://portal.azure.com).
+
+On the portal, go to Resource Groups. In this blade, you can see the Resource Group that you created.
+
+Click on the Resource Group and there it's the resources
+
+![Screen](./images/portal-resource.png)
+
+Congratulations! You have deployed the template successfully.
+
+### Using the Portal
+
+At the Portal, in All Services look for **Templates**, you can favourite this service.
+
+Click in **Add** to add your template:
+
+On General, type the name and the description for your template, and click on [ok].
+
+![Screen](./images/aztemplate2.png)
+
+On ARM Template, replace the content of the template with your template, and click on [OK] and then on [Add].
+
+![Screen](./images/aztemplate3.png)
+
+Click on the refresh button and you will find your template. Click on it and then click in [Deploy].
+
+![Screen](./images/azportaldeploy.png)
+
+On the screen Custom Deployment, inform the values for the parameters, by now you must be already familiar with.
+
+Select [Agree] and click on [Purchase].
+
+![Screen](./images/azportaldeploy2.png)
+
+As you can see, it's deploying.
+
+After a couple of minutes, voilà, you have your Cognitive Service deployed.
+
+![Screen](./images/azportaldeploy3.png)
+
+Go to the Resource. Repeat the test that you have done before.
+
+**p.s.: Pretty easy to create resources on Azure, right? But if you are the sort of IT guy that always loves automation, here is the surprise. Just click on the button below and it will automatically deploy the VM through the  Azure Portal.**
+
+<a href="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2F101-cognitive-services-translate%2Fazuredeploy.json" target="_blank">
+    <img src="https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/1-CONTRIBUTION-GUIDE/images/deploytoazure.png"/>
+</a>
+<a href="http://armviz.io/#/?load=https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2F101-cognitive-services-translate%2Fazuredeploy.json" target="_blank">
+    <img src="https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/1-CONTRIBUTION-GUIDE/images/visualizebutton.png"/>
+</a>
+
+#### Important disclaimer: Azure charges you for the resources you are using, and you don't want to finish all your credits at once, right? So, don't forget to stop the ___Service___ at the portal or even delete the Resource Group you have created to avoid unnecessary charges
+
+### How to delete your resources
+
+#### Using the portal
+
+On the portal, open your Resource Group, if you will not use the Cognitive Service anymore, you can just click on the [Delete] button.
+
+![Screen](./images/delete-rsc.png)