tranlate getting-started page to brazilian portuguese pt-br (#7060)

This commit is contained in:
Jhonn Frazão 2020-04-13 12:09:59 -03:00 committed by GitHub
parent be3a0c7300
commit eedfe4fc5c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 75 additions and 88 deletions

View File

@ -1,6 +1,6 @@
--- ---
title: Getting Started title: Iniciar
description: Download, install, and learn how to evaluate and try Istios basic features quickly. description: Baixar, instalar, e aprender como avaliar e experimentar os recursos básicos do Istio rapidamente.
weight: 5 weight: 5
aliases: aliases:
- /docs/setup/kubernetes/getting-started/ - /docs/setup/kubernetes/getting-started/
@ -9,84 +9,74 @@ aliases:
keywords: [getting-started, install, bookinfo, quick-start, kubernetes] keywords: [getting-started, install, bookinfo, quick-start, kubernetes]
--- ---
To get started with Istio, just follow these three steps: Para iniciar com o Istio, siga estas três etapas:
1. [Set up your platform](#platform) 1. [Configure sua plataforma](#platform)
1. [Download the release](#download) 1. [Faça o download de uma release do Istio](#download)
1. [Install Istio](#install) 1. [Instale o Istio](#install)
## Set up your platform {#platform} ## Configure sua plataforma {#platform}
Before you can install Istio, you need a {{< gloss >}}cluster{{< /gloss >}} running a compatible version of Kubernetes. Antes de instalar o Istio, você precisa de um {{< gloss >}}cluster{{< /gloss >}} executando uma versão compatível do Kubernetes. O Istio {{< istio_version >}} foi testado com as versões {{< supported_kubernetes_versions >}} do Kubernetes.
Istio {{< istio_version >}} has been tested with Kubernetes releases {{< supported_kubernetes_versions >}}.
Create a cluster by selecting the appropriate [platform-specific setup instructions](/pt-br/docs/setup/platform-setup/). Crie um cluster selecionando apropriadamente as [instruções da plataforma especifica](/pt-br/docs/setup/platform-setup/).
Some platforms provide a {{< gloss >}}managed control plane{{< /gloss >}} which you can use instead of Algumas plataformas fornecem um {{< gloss >}}managed control plane{{< /gloss >}} que você pode usar em vez de instalar o Istio manualmente. Se esse for o caso da sua plataforma selecionada e você optar por usá-la, você terá concluido a instalação do Istio após a criação do cluster, então você poderá pular as instruções a seguir. Consulte o seu provedor de serviços de plataforma para obter mais detalhes e instruções.
installing Istio manually. If this is the case with your selected platform, and you choose to use it,
you will be finished installing Istio after creating the cluster, so you can skip the following instructions.
Refer to your platform service provider for further details and instructions.
## Download the release {#download} ## Faça o download de uma release do Istio {#download}
Download the Istio release which includes installation files, samples, and the Faça o download de uma release do Istio, que inclui arquivos de instalação, exemplos e o utilitário de linha de comando [{{< istioctl >}}](/pt-br/docs/reference/commands/istioctl/).
[{{< istioctl >}}](/pt-br/docs/reference/commands/istioctl/) command line utility.
1. Go to the [Istio release]({{< istio_release_url >}}) page to 1. Vá para a página de [release do Istio]({{< istio_release_url >}}) para baixar o arquivo de instalação correspondente ao seu sistema operacional. Como alternativa, em um sistema macOS ou Linux, você pode executar o seguinte comando para baixar e extrair a versão mais recente automaticamente:
download the installation file corresponding to your OS. Alternatively, on a macOS or
Linux system, you can run the following command to download and
extract the latest release automatically:
{{< text bash >}} {{< text bash >}}
$ curl -L https://istio.io/downloadIstio | sh - $ curl -L https://istio.io/downloadIstio | sh -
{{< /text >}} {{< /text >}}
1. Move to the Istio package directory. For example, if the package is 1. Entre no diretório do pacote do Istio. Por exemplo, se o nome do pacote for
`istio-{{< istio_full_version >}}`: `istio-{{< istio_full_version >}}`:
{{< text bash >}} {{< text bash >}}
$ cd istio-{{< istio_full_version >}} $ cd istio-{{< istio_full_version >}}
{{< /text >}} {{< /text >}}
The installation directory contains: O diretório de instalação contém:
- Installation YAML files for Kubernetes in `install/kubernetes` - Arquivos YAML de instalação do Kubernetes em `install/kubernetes`
- Sample applications in `samples/` - Exemplos de aplicações em `samples/`
- The [`istioctl`](/pt-br/docs/reference/commands/istioctl) client binary in the `bin/` directory. `istioctl` is - O binário [`istioctl`](/pt-br/docs/reference/commands/istioctl) no diretório `bin/`. `istioctl` é
used when manually injecting Envoy as a sidecar proxy. usado quando injetamos manualmente o Envoy como um proxy sidecar.
1. Add the `istioctl` client to your path, on a macOS or 1. Adicione o cliente `istioctl` ao seu path, em um sistema macOS ou Linux:
Linux system:
{{< text bash >}} {{< text bash >}}
$ export PATH=$PWD/bin:$PATH $ export PATH=$PWD/bin:$PATH
{{< /text >}} {{< /text >}}
1. You can optionally enable the [auto-completion option](/pt-br/docs/ops/diagnostic-tools/istioctl#enabling-auto-completion) when working with a bash or ZSH console. 1. Você pode habilitar opcionalmente a [opção de auto-completion](/pt-br/docs/ops/diagnostic-tools/istioctl#enabling-auto-completion) se estiver usando os consoles bash ou ZSH .
## Install Istio {#install} ## Instale o Istio {#install}
These instructions assume you are new to Istio, providing streamlined instruction to Essas instruções pressupõem que você é novo no Istio, fornecendo instruções simplificadas para instalar
install Istio's built-in `demo` [configuration profile](/pt-br/docs/setup/additional-setup/config-profiles/). o [perfil de configuração](/pt-br/docs/setup/additional-setup/config-profiles/) de `demo` embutido no Istio.
This installation lets you quickly get started evaluating Istio. Esta instalação permite iniciar rapidamente a avaliação do Istio.
If you are already familiar with Istio or interested in installing other configuration profiles Se você já conhece o Istio ou está interessado em instalar outros perfis de configuração
or a more advanced [deployment model](/pt-br/docs/ops/deployment/deployment-models/), ou um [modelo de deploy](/pt-br/docs/ops/deployment/deployment-models/)
follow the [installing with {{< istioctl >}} instructions](/pt-br/docs/setup/install/istioctl) instead. mais avançado, siga [as instruções de instalação com {{< istioctl >}}](/pt-br/docs/setup/install/istioctl).
{{< warning >}} {{< warning >}}
The demo configuration profile is not suitable for performance evaluation. It O perfil de configuração da demonstração não é adequado para avaliação de desempenho.
is designed to showcase Istio functionality with high levels of tracing and Ele foi projetado para mostrar a funcionalidade do Istio com altos níveis de rastreamento e log de acesso.
access logging.
{{< /warning >}} {{< /warning >}}
1. Install the `demo` profile 1. Instale o perfil `demo`
{{< text bash >}} {{< text bash >}}
$ istioctl manifest apply --set profile=demo $ istioctl manifest apply --set profile=demo
{{< /text >}} {{< /text >}}
1. Verify the installation by ensuring the following Kubernetes services are deployed and verify they all 1. Verifique a instalação, assegurando que os seguintes serviços Kubernetes estejam implementados e
have an appropriate `CLUSTER-IP` except the `jaeger-agent` service: verifique se todos têm um `CLUSTER-IP` apropriado, exceto o serviço `jaeger-agent`:
{{< text bash >}} {{< text bash >}}
$ kubectl get svc -n istio-system $ kubectl get svc -n istio-system
@ -110,14 +100,13 @@ access logging.
{{< /text >}} {{< /text >}}
{{< tip >}} {{< tip >}}
If your cluster is running in an environment that does not Se o cluster estiver em execução em um ambiente que não suporta
support an external load balancer (e.g., minikube), the um balanceador de carga externo (por exemplo, minikube), o
`EXTERNAL-IP` of `istio-ingressgateway` will say `EXTERNAL-IP` do `istio-ingressgateway` mostrará `<pending>`.
`<pending>`. To access the gateway, use the service's Para acessar o gateway, use o `NodePort` do serviço ou use um port-forwarding.
`NodePort`, or use port-forwarding instead.
{{< /tip >}} {{< /tip >}}
Also ensure corresponding Kubernetes pods are deployed and have a `STATUS` of `Running`: Verifique também se os pods Kubernetes correspondentes estão implantados e têm um `STATUS` de `Running`:
{{< text bash >}} {{< text bash >}}
$ kubectl get pods -n istio-system $ kubectl get pods -n istio-system
@ -136,70 +125,68 @@ access logging.
prometheus-67cdb66cbb-9w2hm 1/1 Running 0 1m prometheus-67cdb66cbb-9w2hm 1/1 Running 0 1m
{{< /text >}} {{< /text >}}
## Next steps ## Próximos passos
With Istio installed, you can now deploy your own application or one of the sample applications Com o istio instalado, agora você pode fazer o deploy de suas próprias aplicações ou usar uma
provided with the installation. das aplicações de exemplo fornecidas com a instalação.
{{< warning >}} {{< warning >}}
The application must use either the HTTP/1.1 or HTTP/2.0 protocols for all its HTTP A aplicação dever usar os protocolos HTTP/1.1 ou HTTP/2.0
traffic; HTTP/1.0 is not supported. para todo o tráfego HTTP; HTTP/1.0 não é suportado.
{{< /warning >}} {{< /warning >}}
When you deploy your application using `kubectl apply`, Quando você faz o deploy de sua aplicação usando o `kubectl apply`,
the [Istio sidecar injector](/pt-br/docs/setup/additional-setup/sidecar-injection/#automatic-sidecar-injection) o [Istio sidecar injector](/pt-br/docs/setup/additional-setup/sidecar-injection/#automatic-sidecar-injection)
will automatically inject Envoy containers into your injeta automaticamente contêineres Envoy nos seus pods se eles forem iniciados em namespaces
application pods if they are started in namespaces labeled with `istio-injection=enabled`: com label `istio-injection=enabled`:
{{< text bash >}} {{< text bash >}}
$ kubectl label namespace <namespace> istio-injection=enabled $ kubectl label namespace <namespace> istio-injection=enabled
$ kubectl create -n <namespace> -f <your-app-spec>.yaml $ kubectl create -n <namespace> -f <your-app-spec>.yaml
{{< /text >}} {{< /text >}}
In namespaces without the `istio-injection` label, you can use Em namespaces sem a label `istio-injection`, você pode usar o
[`istioctl kube-inject`](/pt-br/docs/reference/commands/istioctl/#istioctl-kube-inject) [`istioctl kube-inject`](/pt-br/docs/reference/commands/istioctl/#istioctl-kube-inject)
to manually inject Envoy containers in your application pods before deploying para injetar manualmente containers Envoy nos pods da sua aplicação antes de fazer o deploy:
them:
{{< text bash >}} {{< text bash >}}
$ istioctl kube-inject -f <your-app-spec>.yaml | kubectl apply -f - $ istioctl kube-inject -f <your-app-spec>.yaml | kubectl apply -f -
{{< /text >}} {{< /text >}}
If you are not sure where to begin, Se você não sabe por onde começar, faça o
[deploy the Bookinfo sample](/pt-br/docs/examples/bookinfo/) [deploy do exemplo Bookinfo](/pt-br/docs/examples/bookinfo/),
which will allow you to evaluate Istio's features for traffic routing, fault injection, rate que permitirá avaliar os recursos do Istio para roteamento de tráfego, injeção de falhas, limitação de taxa etc.
limiting, etc. Then explore the various [Istio tasks](/pt-br/docs/tasks/) that interest you. Em seguida, explore as várias [tarefas do Istio](/pt-br/docs/tasks/) que lhe interessam.
The following tasks are a good place for beginners to start: As tarefas a seguir são um bom local para iniciantes:
- [Request routing](/pt-br/docs/tasks/traffic-management/request-routing/) - [Roteamento de request](/pt-br/docs/tasks/traffic-management/request-routing/)
- [Fault injection](/pt-br/docs/tasks/traffic-management/fault-injection/) - [Injeção de falha](/pt-br/docs/tasks/traffic-management/fault-injection/)
- [Traffic shifting](/pt-br/docs/tasks/traffic-management/traffic-shifting/) - [Migrando tráfego](/pt-br/docs/tasks/traffic-management/traffic-shifting/)
- [Querying metrics](/pt-br/docs/tasks/observability/metrics/querying-metrics/) - [Consultando métricas](/pt-br/docs/tasks/observability/metrics/querying-metrics/)
- [Visualizing metrics](/pt-br/docs/tasks/observability/metrics/using-istio-dashboard/) - [Visualizando métricas](/pt-br/docs/tasks/observability/metrics/using-istio-dashboard/)
- [Collecting logs](/pt-br/docs/tasks/observability/logs/collecting-logs/) - [Coletando logs](/pt-br/docs/tasks/observability/logs/collecting-logs/)
- [Rate limiting](/pt-br/docs/tasks/policy-enforcement/rate-limiting/) - [Limitando tráfego](/pt-br/docs/tasks/policy-enforcement/rate-limiting/)
- [Ingress gateways](/pt-br/docs/tasks/traffic-management/ingress/ingress-control/) - [Ingress gateways](/pt-br/docs/tasks/traffic-management/ingress/ingress-control/)
- [Accessing external services](/pt-br/docs/tasks/traffic-management/egress/egress-control/) - [Acessando serviços externos](/pt-br/docs/tasks/traffic-management/egress/egress-control/)
- [Visualizing your mesh](/pt-br/docs/tasks/observability/kiali/) - [Visualizando sua mesh](/pt-br/docs/tasks/observability/kiali/)
The next step is to customize Istio and deploy your own applications. O próximo passo é personalizar o Istio e fazer o deploy de suas próprias aplicações.
Before you install and customize Istio to fit your platform and intended use, Antes de instalar e personalizar o Istio para se adequar à sua plataforma e uso
check out the following resources: pretendido, confira os seguintes recursos:
- [Deployment models](/pt-br/docs/ops/deployment/deployment-models/) - [Modelos de deployment](/pt-br/docs/ops/deployment/deployment-models/)
- [Deployment best practices](/pt-br/docs/ops/best-practices/deployment/) - [Melhores práticas de deployment](/pt-br/docs/ops/best-practices/deployment/)
- [Pod requirements](/pt-br/docs/ops/deployment/requirements/) - [Requisitos do Pod](/pt-br/docs/ops/deployment/requirements/)
- [General installation instructions](/pt-br/docs/setup/) - [Instruções gerais de instalação](/pt-br/docs/setup/)
As you continue to use Istio, we look forward to hearing from you and welcoming Enquanto você continua a usar o Istio, estamos ansiosos para ouvi-lo e recebê-lo
you to our [community](/pt-br/about/community/join/). em nossa [comunidade](/pt-br/about/community/join/).
## Uninstall ## Desinstalar
The uninstall deletes the RBAC permissions, the `istio-system` namespace, and A desinstalação exclui as permissões RBAC, a namespace `istio-system` e
all resources hierarchically under it. It is safe to ignore errors for todos os recursos hierarquicamente sob ele. É seguro ignorar erros para recursos inexistentes porque eles podem ter sido excluídos hierarquicamente.
non-existent resources because they may have been deleted hierarchically.
{{< text bash >}} {{< text bash >}}
$ istioctl manifest generate --set profile=demo | kubectl delete -f - $ istioctl manifest generate --set profile=demo | kubectl delete -f -