Skip to content

Commit 09ca8d3

Browse files
committed
ptbr text review and new texts based on original
1 parent 55e17ea commit 09ca8d3

File tree

1 file changed

+25
-21
lines changed

1 file changed

+25
-21
lines changed

src/content/3/pt/part3b.md

Lines changed: 25 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ host: example.com
4444
port: 80
4545
```
4646

47-
Quando você visita um site (ou seja, <http://catwebsites.com>), o navegador emite uma requisição para o servidor em que o site (catwebsites.com) está hospedado. A resposta enviada pelo servidor é um arquivo HTML que pode conter uma ou mais referências a recursos/ativos externos hospedados no mesmo servidor que <i>catwebsites.com</i> está hospedado ou em um site diferente. Quando o navegador vê referência(s) a uma URL no HTML de origem, ele emite uma requisição. Se a requisição for feita usando a URL da qual o HTML de origem foi obtido, o navegador processa a resposta sem problemas. No entanto, se o recurso for obtido usando uma URL que não compartilha a mesma origem (esquema, host, porta) que o HTML de origem, o navegador deverá verificar o cabeçalho de resposta _Access-Control-Allow-origin_ (CORS). Se ele contiver _*_ ou a URL do HTML de origem, o navegador processará a resposta, caso contrário, o navegador se recusará a processá-la e lançará um erro.
47+
Quando você visita um site (ou seja, <http://catwebsites.com>), o navegador emite uma requisição para o servidor em que o site (catwebsites.com) está hospedado. A resposta enviada pelo servidor é um arquivo HTML que pode conter uma ou mais referências a recursos/ativos externos hospedados no mesmo servidor que <i>catwebsites.com</i> está hospedado ou em um site diferente. Quando o navegador vê referência(s) a uma URL no HTML de origem, ele emite uma requisição. Se a requisição for feita usando a URL na qual o HTML de origem foi obtido, o navegador processa a resposta sem problemas. No entanto, se o recurso for obtido usando uma URL que não compartilha a mesma origem (esquema, host, porta) que o HTML de origem, o navegador deverá verificar o cabeçalho de resposta _Access-Control-Allow-origin_ (CORS). Se ele contiver _*_ ou a URL do HTML de origem, o navegador processará a resposta, caso contrário, o navegador se recusará a processá-la e lançará um erro.
4848

4949
A <strong>Política de Mesma Origem</strong> é um mecanismo de segurança implementado pelos navegadores para impedir sequestro de sessão (session hijacking), entre outras vulnerabilidades de segurança.
5050

@@ -85,13 +85,13 @@ A aplicação React sendo executada no navegador agora obtém os dados do servid
8585

8686
### A Aplicação na Internet
8787

88-
Agora que toda a pilha (stack) está pronta, vamos mover nossa aplicação para a internet.
88+
Agora que toda <i>stack</i> está pronta, vamos mover nossa aplicação para a internet.
8989

9090
Há um número cada vez maior de serviços que podem ser usados para hospedar uma aplicação na internet. Serviços voltados a desenvolvedores (developer-friendly services), como o PaaS (Platform as a Service [Plataforma como Serviço]), cuidam da instalação do ambiente de execução (Node.js, por exemplo) e também podem fornecer vários serviços, como bancos de dados.
9191

9292
Durante uma década, [Heroku](http://heroku.com) dominou a cena PaaS. Infelizmente, o plano gratuito do Heroku acabou em 27 de novembro de 2022. Muitos desenvolvedores ficaram tristes com isso, especialmente estudantes. O Heroku ainda é uma opção viável se você estiver disposto a gastar algum dinheiro. Eles também têm [um programa para estudantes](https://www.heroku.com/students) que fornece alguns créditos gratuitos.
9393

94-
Agora estamos apresentando dois serviços: [Fly.io](https://fly.io/) e [Render](https://render.com/), onde ambos têm um plano gratuito (limitado). O Fly.io é nosso serviço de hospedagem "oficial", pois pode ser usado com certeza também nas Partes 11 e 13 do curso. O Render será bom pelo menos para as outras partes deste curso.
94+
Agora estamos apresentando dois serviços: [Fly.io](https://fly.io/) e [Render](https://render.com/), ambos possuem um plano gratuito (limitado). O Fly.io é nosso serviço de hospedagem "oficial", pois pode ser usado com certeza também nas Partes 11 e 13 do curso. O Render será bom pelo menos para as outras partes deste curso.
9595

9696
Observe que, apesar de usar apenas o plano gratuito, o Fly.io <i>pode</i> exigir que você insira suas informações de cartão de crédito. No momento, o Render pode ser usado sem um cartão de crédito.
9797

@@ -113,7 +113,7 @@ Tanto para o Fly.io quanto para o Render, precisamos mudar, no final do arquivo
113113
```js
114114
const PORT = process.env.PORT || 3001 // highlight-line
115115
app.listen(PORT, () => {
116-
console.log(`Server running on port (Servidor em execução na porta) ${PORT}`)
116+
console.log(`Server running on port ${PORT}`)
117117
})
118118
```
119119

@@ -184,15 +184,15 @@ fly deploy
184184

185185
Um comando particularmente importante é _fly logs_. Este comando pode ser usado para visualizar os logs do servidor. É melhor manter os logs sempre visíveis!
186186

187-
**Atenção:** Em alguns casos (a causa é até agora desconhecida) executar comandos Fly.io, especialmente no Windows WSL, causou problemas. Se o seguinte comando simplesmente travar...
187+
**Atenção:** Em alguns casos (a causa é até agora desconhecida) executar comandos Fly.io, especialmente no Windows WSL, causou problemas. Se o seguinte comando simplesmente travar:
188188

189189
```bash
190190
flyctl ping -o personal
191191
```
192192

193-
... seu computador não consegue, por algum motivo, se conectar ao Fly.io. Se isso acontecer com você, [aqui](https://github.com/fullstack-hy2020/misc/blob/master/fly_io_problem.md) encontra-se uma possível maneira de resolver o problema.
193+
seu computador não consegue, por algum motivo, se conectar ao Fly.io. Se isso acontecer com você, [aqui](https://github.com/fullstack-hy2020/misc/blob/master/fly_io_problem.md) encontra-se uma possível maneira de resolver o problema.
194194

195-
Se a saída do comando abaixo se parecer com isto...
195+
Se a saída do comando abaixo se parecer com isto:
196196

197197
```bash
198198
$ flyctl ping -o personal
@@ -202,54 +202,54 @@ $ flyctl ping -o personal
202202
...
203203
```
204204

205-
... então não há problemas de conexão!
205+
então não há problemas de conexão!
206206

207207
#### Render
208208

209209
Este serviço pressupõe que o [login](https://dashboard.render.com/) tenha sido feito com uma conta do GitHub.
210210

211211
Depois de fazer login, vamos criar um novo "Web Service":
212212

213-
![](../../images/3/r1.png)
213+
![imagem mostrando a opção para criar um novo Web Service](../../images/3/r1.png)
214214

215215
O repositório da aplicação é então conectado ao Render:
216216

217-
![](../../images/3/r2.png)
217+
![imagem mostrando o repositório da aplicação no Render](../../images/3/r2.png)
218218

219219
A conexão parece exigir que o repositório da aplicação seja público.
220220

221221
A seguir, definiremos as configurações básicas. Se a aplicação <i>não</i> estiver na raiz do repositório, o <i>diretório raiz</i> precisa receber um valor apropriado:
222222

223-
![](../../images/3/r3.png)
223+
![imagem mostrando o campo Root Directory como sendo opcional](../../images/3/r3.png)
224224

225225
Depois disso, a aplicação é iniciada no Render. O painel informa o estado da aplicação e a URL onde ela está sendo executada:
226226

227-
![](../../images/3/r4.png)
227+
![no canto esquerdo superior da imagem é possível verificar o estado da aplicação e a sua URL](../../images/3/r4.png)
228228

229-
De acordo com a [documentação](https://render.com/docs/deploys), cada confirmação no GitHub deve redesenhar a aplicação. Por alguma razão, isso nem sempre funciona.
229+
De acordo com a [documentação](https://render.com/docs/deploys), cada confirmação no GitHub deve fazer o redeploy (re-implantar) a aplicação. Por alguma razão, isso nem sempre funciona.
230230

231-
Felizmente, também é possível redesenhar manualmente a aplicação:
231+
Felizmente, também é possível fazer o redeploy da aplicação manualmente:
232232

233-
![](../../images/3/r5.png)
233+
![menu com a opção para fazer o deploy novamente em destaque](../../images/3/r5.png)
234234

235235
Também é possível ver os logs da aplicação no painel:
236236

237-
![](../../images/3/r7.png)
237+
![Guia logs no canto esquerdo em destaque. No lado direito, os los da aplicação](../../images/3/r7.png)
238238

239239
Observamos nos logs que a aplicação foi iniciada na porta 10000. O código da aplicação obtém a porta correta por meio da variável de ambiente PORT, portanto, é essencial que o arquivo <i>index.js</i> tenha sido atualizado da seguinte maneira:
240240

241241
```js
242242
const PORT = process.env.PORT || 3001 // highlight-line
243243
app.listen(PORT, () => {
244-
console.log(`Server running on port (Servidor em execução na porta) ${PORT}`)
244+
console.log(`Server running on port ${PORT}`)
245245
})
246246
```
247247

248248
### Build de produção do front-end
249249

250250
Até agora, rodamos o código do React em <i>modo de desenvolvimento</i>. No modo de desenvolvimento, a aplicação é configurada para exibir mensagens de erro claras, renderizar imediatamente as mudanças de código para o navegador, e assim por diante.
251251

252-
Quando a aplicação é implantada (deployed), é necessário criar um [build de produção](https://reactjs.org/docs/optimizing-performance.html#use-the-production-build) (grosso modo, "versão de produção" ou "compilação de produção" ou "estrutura de produção") ou uma versão da aplicação otimizada para produção.
252+
Quando a aplicação é implantada (deployed), é necessário criar um [build de produção](https://reactjs.org/docs/optimizing-performance.html#use-the-production-build), ou seja, uma versão da aplicação otimizada para produção.
253253

254254
Um build de produção de aplicações gerado com <i>create-react-app</i> pode ser criado com o comando [npm run build](https://github.com/facebookincubator/create-react-app#npm-run-build-or-yarn-build).
255255

@@ -413,7 +413,7 @@ O script _npm run build:ui_ constrói o front-end e copia a versão de produçã
413413
414414
Observe que os caminhos de diretório no script <i>build:ui</i> dependem da localização dos repositórios no sistema de arquivos.
415415
416-
>**N.B.:** No Windows, scripts npm são executados em cmd.exe como o shell padrão que não oferece suporte a comandos bash. Para que os comandos bash acima funcionem, é possível alterar o shell padrão para Bash (na instalação padrão do Git para Windows) da seguinte forma:
416+
>**Obs.:** No Windows, scripts npm são executados em cmd.exe como o shell padrão que não oferece suporte a comandos bash. Para que os comandos bash acima funcionem, é possível alterar o shell padrão para Bash (na instalação padrão do Git para Windows) da seguinte forma:
417417
418418
```md
419419
npm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe"
@@ -423,7 +423,7 @@ Outra opção é usar o [shx](https://www.npmjs.com/package/shx).
423423
424424
### Proxy
425425
426-
As alterações no front-end fizeram com que não funcionasse mais no modo de desenvolvimento (quando iniciado com o comando _npm start_), pois a conexão com o back-end não funciona.
426+
As alterações no front-end fizeram com que ele não funcionasse mais no modo de desenvolvimento (quando iniciado com o comando _npm start_), pois a conexão com o back-end não funciona.
427427
428428
![ferramentas do desenvolvedor mostrando um erro 404 ao obter notas](../../images/3/32new.png)
429429
@@ -485,11 +485,15 @@ Teste o recém-implantado back-end com um navegador, com o Postman ou com o clie
485485
486486
Crie um README.md na raiz do seu repositório e adicione um link de acesso à sua aplicação online.
487487
488+
**OBSERVAÇÃO** como dito, o deploy do BACKEND deve ser feito em um serviço de nuvem. Se você estiver usando o Fly.io, o comando deve ser executado no diretório raiz do backend (que é o mesmo diretório onde está o arquivo do backend chamado package.json). No caso de estar usando o Render, o backend deve estar na raiz do seu repositório.
489+
490+
Você NÃO deve fazer o deploy do frontend diretamente nesta parte. O deploy está sendo realizado apenas com o repositório do backend ao longo de toda esta parte do curso.
491+
488492
#### 3.11: Phonebook backend — 11º passo
489493
490494
Gere um build de produção do seu front-end e adicione-o à aplicação na internet utilizando o método introduzido nesta parte.
491495
492-
**N.B.:** Se você usar o Render, certifique-se de que o diretório <i>build</i> não esteja no <i>gitignored</i>.
496+
**Obs.:** Se você usar o Render, certifique-se de que o diretório <i>build</i> não esteja no <i>gitignored</i>.
493497
494498
Certifique-se também de que o front-end ainda funcione localmente (em modo de desenvolvimento quando iniciado com o comando _npm start_).
495499

0 commit comments

Comments
 (0)