Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[pt] Add translations for /pt/docs/concepts/distributions.md #5125

Merged
Merged
Changes from all commits
Commits
Show all changes
37 commits
Select commit Hold shift + click to select a range
0034088
Add translations for /pt/docs/concepts/distributions.md
vitorvasc Aug 29, 2024
cc8a339
Merge branch 'main' into pt_translate_concepts_distributions
vitorvasc Aug 29, 2024
7046204
Fix translation for Collector
vitorvasc Aug 29, 2024
c3d3fbb
Format english terms as italic
vitorvasc Aug 30, 2024
3e5aff2
Merge branch 'main' into pt_translate_concepts_distributions
vitorvasc Aug 30, 2024
4a55369
Merge branch 'main' into pt_translate_concepts_distributions
vitorvasc Sep 2, 2024
a8473a7
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 3, 2024
a8ad146
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 3, 2024
39889c3
Fix how we refer to the OpenTelemetry project
vitorvasc Sep 3, 2024
4e20c65
Fix, rollback translations on how we mention upstream and Registry
vitorvasc Sep 3, 2024
3c2babf
Run linter
vitorvasc Sep 3, 2024
cd47afa
Merge branch 'main' into pt_translate_concepts_distributions
vitorvasc Sep 3, 2024
854957b
Fix typo
vitorvasc Sep 3, 2024
262d5d3
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
59ea0b5
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
17d53ab
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
23ac9fd
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
a2d4767
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
b0cb061
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
dc852ad
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
35f912a
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
f0988f7
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
e4d0ad3
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
c4dded4
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
eb4b403
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
7ea9537
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
1dcdae7
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
3f544cb
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
029e7ef
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
df6e509
Updated as suggested
vitorvasc Sep 5, 2024
b5c2818
Merge branch 'main' into pt_translate_concepts_distributions
vitorvasc Sep 5, 2024
85e7f23
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 5, 2024
13b16d1
Results from /fix:all
opentelemetrybot Sep 5, 2024
9e81dc3
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 6, 2024
9b1bda8
Update content/pt/docs/concepts/distributions.md
vitorvasc Sep 6, 2024
e717131
Results from /fix:all
opentelemetrybot Sep 6, 2024
a389c5d
Merge branch 'main' into pt_translate_concepts_distributions
theletterf Sep 8, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
115 changes: 115 additions & 0 deletions content/pt/docs/concepts/distributions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
---
title: Distribuições
description: >-
Uma distribuição, que não deve ser confundida com um fork, é uma versão
customizada de um componente do OpenTelemetry.
weight: 190
default_lang_commit: 2f34c456ab38b4d3502cd07bc36fa1455d4ef875
---

Os projetos do OpenTelemetry consistem de múltiplos [componentes](../components)
que suportam múltiplos [sinais](../signals). As implementações de referência do
OpenTelemetry estão disponíveis em:

- [Bibliotecas de instrumentação específicas de cada linguagem de programação](../instrumentation)
- Um [binário para o Collector](/docs/concepts/components/#collector)

Qualquer implementação de referência pode ser customizada como uma distribuição.

## O que é uma distribuição? {#what-is-a-distribution}

Uma distribuição é uma versão customizada de um componente do OpenTelemetry. Uma
distribuição é um encapsulamento em torno de um repositório do OpenTelemetry com
algumas customizações. Distribuições não devem ser confundidas com _forks_.

As customizações em uma distribuição podem incluir:

- Scripts para facilitar ou customizar o uso de um _backend_ ou fornecedor
específico
- Alterações nas configurações padrão que são necessárias para um _backend_,
fornecedor ou usuário final
- Pacotes ou bibliotecas adicionais que podem ser específicas para determinado
fornecedor ou usuário final
- Cobertura adicional de testes, performance e segurança além do fornecido pelo
OpenTelemetry
- Funcionalidades adicionais além do que já é fornecido pelo OpenTelemetry
- Remoção de funcionalidades fornecidas pelo OpenTelemetry

As distribuições geralmente se enquadram nas seguintes categorias:

- **"Pura":** Estas distribuições fornecem as mesmas funcionalidades da versão
pública e são 100% compatíveis. As customizações normalmente aprimoram a
facilidade de uso ou configurações. Estas customizações podem ser específicas
para _backends_, fornecedores ou usuários finais.
- **"Plus":** Estas distribuições oferecem funcionalidades adicionais ao que é
encontrado na _upstream_, através de componentes adicionais. Exemplos incluem
bibliotecas de instrumentação ou exportadores de fornecedores que não foram
incluídos na _upstream_ do OpenTelemetry.
- **"Minus":** Estas distribuições fornecem um subconjunto de funcionalidades da
upstream. Exemplos podem incluir a remoção de bibliotecas de instrumentação ou
de receivers, processors, exporters ou extensions encontradas no projeto do
OpenTelemetry Collector. Estas distribuições podem ser fornecidas por questão
de suporte e/ou temas relacionados à segurança.

## Quem pode criar uma distribuição? {#who-can-create-a-distribution}

Qualquer pessoa pode criar uma distribuição. Atualmente, diversos
[fornecedores](/ecosystem/vendors/) oferecem
[distribuições](/ecosystem/distributions). Além disso, usuários finais podem
considerar criar uma distribuição caso queiram usar componentes do
[Registry](/ecosystem/registry) que não foram incluídos na _upstream_ do projeto
do OpenTelemetry.

## Contribuição ou distribuição? {#contribution-or-distribution}

Antes de continuar e aprender como criar sua própria distribuição, pergunte a si
mesmo se as suas adições a um determinado componente do OpenTelemetry seriam
benéficas para todos e, portanto, deveriam ser incluídas nas implementações de
referência:

- Os seus scripts para "facilitar o uso" podem ser generalizados?
- Suas alterações nas configurações padrão podem ser a melhor opção para todos?
- Os seus pacotes ou bibliotecas adicionais são realmente específicos?
- Sua cobertura de testes, performance ou segurança também funcionarão nas
implementações de referência?
- Você verificou com a comunidade se as suas funcionalidades ou comportamentos
adicionais podem se tornar parte do padrão?

## Criando a sua própria distribuição {#creating-your-own-distribution}

### Collector

Um guia sobre como criar a sua própria distribuição está disponível nesta
publicação do blog:
["Building your own OpenTelemetry Collector distribution"](https://medium.com/p/42337e994b63)

Caso você esteja criando a sua própria distribuição, o
[OpenTelemetry Collector Builder](https://github.com/open-telemetry/opentelemetry-collector/tree/main/cmd/builder)
pode ser um bom ponto de partida.

### Bibliotecas de instrumentação específicas para cada linguagem de programação {#language-specific-instrumentation-libraries}

Existem algumas linguagens de programação que exigem mecanismos de
extensibilidade específicos para a customização das bibliotecas de
instrumentação:

- [Java agent](/docs/zero-code/java/agent/extensions)

## Siga as diretrizes {#follow-the-guidelines}

Ao utilizar materiais relacionados ao projeto do OpenTelemetry para
distribuição, como logotipo e nome, certifique-se de estar alinhado com as
[Diretrizes de Marketing do OpenTelemetry para Organizações
Contribuintes][diretrizes].

O projeto do OpenTelemetry não certifica distribuições neste momento. No futuro,
o OpenTelemetry poderá certificar distribuições e parceiros de maneira
semelhante ao que ocorre no projeto Kubernetes. Ao avaliar uma distribuição,
assegure-se de que seu uso não irá resultar em uma dependência de fornecedor
(_vendor lock-in_).

> Qualquer suporte para uma distribuição deve ser fornecido diretamente por quem
> a criou e não pelas pessoas envolvidas no projeto do OpenTelemetry.

[diretrizes]:
https://github.com/open-telemetry/community/blob/main/marketing-guidelines.md