mirror of https://github.com/istio/istio.io.git
tranlate getting-started page to brazilian portuguese pt-br (#7060)
This commit is contained in:
parent
be3a0c7300
commit
eedfe4fc5c
|
@ -1,6 +1,6 @@
|
||||||
---
|
---
|
||||||
title: Getting Started
|
title: Iniciar
|
||||||
description: Download, install, and learn how to evaluate and try Istio’s 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 -
|
||||||
|
|
Loading…
Reference in New Issue