docker_images

AdoptOpenJDK · May 20, 2017 · f1661d8 · f1661d8
1 parent 1a0c301
commit f1661d8
Show file tree

Hide file tree

Showing 16 changed files with 497 additions and 0 deletions.
diff --git a/pt/docker-images/build-images.md b/pt/docker-images/build-images.md
@@ -0,0 +1,8 @@
+# Construir imagens
+
+* Pré-requisito: *Conhecimento prévio de Docker nas respectivas plataformas, apesar de os links terem sido fornecidos na seção de introdução do post.*
+
+Detalhes passo a passo sobre como uma imagem Docker OpenJDK9 pode ser construída a partir do zero para Linux, MacOS e Windows podem ser encontrada aqui:
+
+- [Buildar #OpenJDK 9 usando #Docker, porque não? - Parte 1 de 2](https://neomatrix369.wordpress.com/2015/06/04/why-not-build-openjdk-9-using-docker/)
+- [Buildar #OpenJDK 9 usando #Docker, porque não? - Parte 2 de 2](https://neomatrix369.wordpress.com/2015/06/06/why-not-build-openjdk-9-using-docker-part-2-of-2/)
diff --git a/pt/docker-images/check-images.md b/pt/docker-images/check-images.md
@@ -0,0 +1,38 @@
+# Verificar imagens
+
+* Nota: *Esta etapa é aplicável se você já tiver imagens OpenJDK construídas ou carregadas previamente em seu repositório Docker local.*
+
+Carregue o docker no respectivo ambiente usando o comando usual ```boot2docker up``` para os usuários *MacOS* e *Windows*. Para usuários de Linux isso é carregado durante a inicialização.
+
+Execute os comandos abaixo:
+
+```
+$ docker images
+```
+
+Você verá algo como:
+```
+REPOSITORY                             TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
+neomatrix369/openjdk9                  latest              5877e8efd939        4 days ago          5.82 GB
+neomatrix369/full-image-openjdk9       latest              32b0a686e93b        4 days ago          5.82 GB
+neomatrix369/base-image-openjdk9       latest              ce63b2673e6a        4 days ago          781.7 MB
+phusion/baseimage                      latest              5a14c1498ff4        4 months ago        279.7 MB
+```
+
+Agora execute estes comandos:
+
+```
+$ sudo docker run -it --name openjdk9 neomatrix369/openjdk9  /bin/bash
+```
+Isso leva você para o shell dentro do container
+
+```
+$ sudo docker run -it --name openjdk9 neomatrix369/openjdk9 java -version
+```
+Isto irá executar o comando ```java``` e você verá a saída abaixo (apenas se encontrar ```java``` através das variáveis de ambiente ```PATH``` ou ```JAVA_HOME```):
+
+```
+openjdk version "1.9.0-internal"
+OpenJDK Runtime Environment (build 1.9.0-internal-_2015_06_04_06_46-b00)
+OpenJDK 64-Bit Server VM (build 1.9.0-internal-_2015_06_04_06_46-b00, mixed mode)
+```
diff --git a/pt/docker-images/copy-images.md b/pt/docker-images/copy-images.md
@@ -0,0 +1,52 @@
+# Copiar imagens
+
+As imagens podem ser de portáteis e carregadas de volta para o repositório Docker.
+
+**Salvar uma imagem**
+```
+docker save -o <caminho para a imagem> <nome da imaem>
+```
+ou
+```
+docker save <nome da imagem> > <caminho para salvar a imagem>
+```
+
+For e.g.
+```
+docker save -o base-image-openjdk9.tar neomatrix369/openjdk9-base-image:latest 
+```
+ou
+```
+docker save neomatrix369/openjdk9-base-image:latest >  openjdk9-base-image.tar
+```
+ou
+
+```
+docker save neomatrix369/openjdk9-base-image:latest | gzip > openjdk9-base-image.tar.gz
+```
+
+```openjdk9-base-image.tar``` ou ```openjdk9-base-image.tar.gz``` são criados no diretório onde a imagem é executada.
+
+**Carregar imagem**
+```
+docker load -i <caminho para o arquivo .tar>
+```
+ou
+
+```
+docker load < <caminho para o arquivo .tar>
+```
+
+Exemplo:
+```
+docker load -i openjdk9-base-image.tar 
+```
+ou
+```
+docker load < openjdk9-base-image.tar
+```
+ou
+
+```
+docker load < gzip < openjdk9-base-image.tar.gz
+```
diff --git a/pt/docker-images/docker-images.md b/pt/docker-images/docker-images.md
@@ -0,0 +1,5 @@
+# Imagens Docker
+
+   * [Copiar Images](copy-images.md)
+   * [Construir Images](build-images.md)
+   * [Verificar Images](check-images.md)
diff --git a/pt/how-to-navigate/additional-pre-hackday-actions-experienced.md b/pt/how-to-navigate/additional-pre-hackday-actions-experienced.md
@@ -0,0 +1,44 @@
+# Ações adicionais pré-hackday para participantes experientes
+
+##### Construa sua própria VM
+
+Nota: você precisará de boa conexão de internet para baixar os arquivos e tempo suficiente para a compilação terminar. ** Não aconcelhável através de uma conexão wi-fi. **
+
+<br/>
+[Construa sua própria VM](../virtual-machines/build_your_own_vm.md) <br/>
+[Construa sua própria VM leve](../virtual-machines/build_your_own_lightweight_vm.md)
+
+<br/>
+##### Verificar VM
+- Carregar a VM na VirtualBox
+- Iniciar a VM
+- Executar qualquer programa dentro da VM
+- Desligar a VM
+
+<br/>
+##### Download/cópia de Docker Images
+Quando as imagens são baixadas, elas podem ser copiadas de um local ou dispositivo para outro, veja a seção [Copiar Imagens](../docker-images/copy-images.md).
+
+ou
+<br/>
+##### Construir imagens
+Verificar [Construir Images](../docker-images/build-images.md) em imagens do Docker.
+
+<br/>
+##### Verificar Imagens
+Verificar [Construir Imagens](../docker-images/check-images.md) em Imagens do Docker.
+
+<br/>
+##### Verificar instalação e ambiente
+Inicie a VM ou Docker container, navegue até as pastas jdk8 ou jdk9 e execute o comando abaixo:
+
+```
+bash configure
+make clean images
+```
+
+Se algo falhar, então o ambiente OpenJDK não está corretamente definido ou o código da OpenJDK está quebrado.
+
+<br/>
+##### Finalmente
+Quando terminar, vá para a seção [Como navegar e fazer progresso?](how-to-navigate-and-make-progress.md) vá para a próxima etapa para continuar com o fluxo.
diff --git a/pt/how-to-navigate/advanced-level.md b/pt/how-to-navigate/advanced-level.md
@@ -0,0 +1,7 @@
+### Nível avançado
+
+##### Sou experiente/regular em hackdays OpenJDK, sei muito sobre tech/Java/JVM/OpenJDK, o que você tem para mim?
+
+- [Argumentos de linha de comando para otimização de desempenho de compilação](../anced-steps/command-line_arguments_for_build_performance_optimisation.md)
+- [Navegar pelos passos avançados](../advanced-steps/advanced_steps.md) com mais atenção.
+- Finalmente quando você terminar com o ítem acima, dê uma olhada na [Tabela de Conteúdo](http://adoptopenjdk.gitbooks.io/adoptopenjdk-getting-started-kit/content/) para ver se você não esqueceu nada da lista.
diff --git a/pt/how-to-navigate/beginners-level.md b/pt/how-to-navigate/beginners-level.md
@@ -0,0 +1,8 @@
+### Nível principiante
+
+##### Eu sou um estudante/iniciante, novo para a OpenJDK, quero aprender, nunca fui a hackdays OpenJDK antes, por onde eu começo?
+
+- [Adopt OpenJDK - Getting started](../adopt-openjdk-getting-started/adopt_openjdk_-_getting_started.md) - leia as páginas e subpáginas brevemente, leia-as em detalhes em casa ou no seu tempo livre.
+- [Virtual Machines](../virtual-machines/virtual_machines.md) - navegue por essas páginas e construa ou transfira uma VM dependendo da sua disponibilidade e largura de banda. Ou solicite uma VM aos responsáveis (consulte a página para obter mais instruções).
+- [Builde a seu próprio OpenJDK](../binaries/build_your_own_openjdk.md) - passe por esta seção e utilize a VM da etapa anterior para construir a respectiva versão do OpenJDK.
+- Finalmente ir para a próxima etapa [Nível intermediário](../how-to-navigate/intermediate-level.md).
diff --git a/pt/how-to-navigate/contribute.md b/pt/how-to-navigate/contribute.md
@@ -0,0 +1,43 @@
+# Como contribuir para este livro?
+
+## Contribuir via GitBook
+
+Crie uma conta no [gitbook.com](http://www.gitbook.com/login) e [envie uma solicitação para se tornar um colaborador]((https://www.gitbook.com/book/adoptopenjdk/adoptopenjdk-getting-started-kit/contact) do [AdoptOpenJDK GitBook](http://adoptopenjdk.gitbooks.io/adoptopenjdk-getting-started-kit/)
+
+[Documentações](http://help.gitbook.com/) e [como instalar o GitBook](https://github.com/GitbookIO/gitbook) localmente também devem ajudar no processo.
+
+## Contribuir via GitHub
+
+1. Faça um Fork do projeto
+Visite este site para criar um fork: **https://github.com/adoptopenjdk/adoptopenjdk-getting-started-kit#fork-destination-box**
+
+2. Clone em sua máquina <br/>
+```git clone git@github.com:{YOUR_GITHUB_ACCOUNT}/adoptopenjdk-getting-started-kit.git```
+
+3. Adicione Upstream <br/>
+```git remote add --track master upstream git://github.com/adoptopenjdk/adoptopenjdk-getting-started-kit.git```
+
+Agora você pode atualizar seu fork com o repositório original:
+```git fetch upstream``` 
+and 
+```git merge upstream/master```
+
+4. Comitar arquivos modificados <br/>
+```git add <changes files/wild-card pattern>```<br/>
+```git commit -am "mensagem descrevendo as alterações"```
+
+5. Enviar arquivos
+```git push```
+
+6. Crie um pull request
+Visite seu repositório no GitHub: https://github.com/{YOUR_GITHUB_ACCOUNT}/adoptopenjdk-getting-started-kit/pulls e clique no botão New Pull Request e crie um novo.
+
+## Como identificar alterações no livro?
+
+Temos dois [scripts](https://github.com/adoptopenjdk/adoptopenjdk-getting-started-kit) na pasta raiz do repo que criam páginas markdown <b> What's changed </b>, como esta<br/> http://adoptopenjdk.gitbooks.io/adoptopenjdk-getting-started-kit/content/en/whatsChanged.html.
+
+Os scripts geradores de markdown [What's changed](http://adoptopenjdk.gitbooks.io/adoptopenjdk-getting-started-kit/content/en/whatsChanged.html) são chamados [whatsChanged.sh](https://github.com /adoptopenjdk/adoptopenjdk-getting-started-kit/blob/master/whatsChangedFor.sh) e [whatsChangedForAllLanguages.sh](https://github.com/adoptopenjdk/adoptopenjdk-getting-started-kit/blob/master/whatsChangedFor. Sh).
+
+Sinta-se livre para melhorá-los, desde que continuem a fazer o que fazem.
+
+Consulte também [Feedback](../backup.md) e [Como contribuir para Adotar OpenJDK e OpenJDK?](how_to_contribute_to_adopt_openjdk_and_openjdk.md)
diff --git a/pt/how-to-navigate/contribute_to_this_book.md b/pt/how-to-navigate/contribute_to_this_book.md
@@ -0,0 +1,13 @@
+### Contribua para este livro
+
+##### Eu sei coisas que eu quero compartilhar, e gostaria de contribuir para este livro.
+
+Faça o descrito abaixo e você pode começar imediatamente a contribuir através do modelo de colaboração disponível no github:
+
+Clone o repo **https: //www.gitbook.com/book/adoptopenjdk/adoptopenjdk-getting-started-kit**, faça suas modificações e crie um pull request.
+
+ou
+
+Você também pode [contactar](https://www.gitbook.com/book/adoptopenjdk/adoptopenjdk-getting-started-kit/contact) os autores com seu nome de usuário github para ser adicionado ao repo.
+
+Algumas [documentações](http://help.gitbook.com/) e [como instalar o GitBook](https://github.com/GitbookIO/gitbook) localmente também devem ajudar no processo.
diff --git a/pt/how-to-navigate/free-time-ample-bandwidth.md b/pt/how-to-navigate/free-time-ample-bandwidth.md
@@ -0,0 +1,9 @@
+### Se eu encontrar tempo em casa e possuir uma boa largura de banda, como melhor tirar proveito desta situação?
+
+Passe por estas seções em um ritmo mais lento:
+
+* [Adotar OpenJDK - Introdução](../adopt-openjdk-getting-started/adopt_openjdk_-_getting_started.md)
+* [Máquinas Virtuais](../virtual-machines/virtual_machines.md)
+* [Binários](../binaries/binaries.md)
+
+Se você terminar, dê uma olhada na [Tabela de Conteúdo](http://adoptopenjdk.gitbooks.io/adoptopenjdk-getting-started-kit/content/) e verifique se você ainda não deixou nada para trás.
diff --git a/pt/how-to-navigate/how-to-navigate-and-make-progress.md b/pt/how-to-navigate/how-to-navigate-and-make-progress.md
@@ -0,0 +1,46 @@
+# Como navegar e fazer progresso?
+
+##### O que eu faço dias antes de um hackday ou workshop?
+Venha preparado com sua configuração de laptop e ambiente necessário para o dia.
+- Verifique se há requisitos mínimos de software/plataforma de hardware/SO
+- Faça o download do software de suporte
+- Criar ou fazer download de máquinas virtuais
+- Construir ou descarregar imagens Docker
+- Verificar se a VM funciona ou se a imagem do Docker funciona
+- Verificar se a build da OpenJDK funciona
+
+Veja [Como se preparar antes de participar de um hackday ou oficina?](prepare-before-hackday.md) para uma explicação detalhada dos pontos acima.
+
+Se isso não se aplica a você ou você já fez isso, por favor verifique as seções abaixo.
+
+##### Como configurar o ambiente em sua máquina no dia?
+
+Depois de ter passado por [O que devo fazer dias antes de um hackday ou workshop?](prepare-before-hackday.md), consulte [Como configurar o ambiente na sua máquina no dia?](prepare-an-environment-machine.md).
+
+Se isso não se aplica a você ou você já fez isso, por favor verifique as seções abaixo.
+
+
+##### Eu sou um estudante/iniciante, muito novo para Adotar OpenJDK, quero aprender, nunca foi a hackdays OpenJDK antes, onde eu começo?
+Procure os passos [Beginners level](beginners-level.md).
+
+<br/>
+##### Eu sou um estudante/profissional, com um pouco de experiência para Adotar OpenJDK, já fui a hackdays da OpenJDK antes, onde eu posso ir?
+
+Procure os passos [nível intermediário](intermediate-level.md).
+
+<br/>
+##### Eu sou um especialista regular em hackdays OpenJDK, sei muito sobre tech/Java/JVM/OpenJDK, o que você tem para mim?
+
+Procure os passos [Nível avançado](advanced-level.md).
+
+<br/>
+##### Se eu encontrar tempo em casa e tiver a largura de banda que eu preciso, como melhor tirar proveito desta situação? Ou o que eu faço depois de ter terminado de assistir a um hackday ou workshop.
+
+Olhe o que você deve fazer para fazer o melhor uso do seu tempo para aprender (freetime-ample-bandwidth.md).
+
+<br/>
+##### Eu sei coisas que eu quero compartilhar, e gostaria de contribuir para este livro?
+
+Dê uma olhada em [Como contribuir para este livro](contribute.md) e [Como contribuir para Adotar OpenJDK e OpenJDK?](how_to_contribute_to_adopt_openjdk_and_openjdk.md)
+
+<br/>
diff --git a/pt/how-to-navigate/how_to_contribute_to_adopt_openjdk_and_openjdk.md b/pt/how-to-navigate/how_to_contribute_to_adopt_openjdk_and_openjdk.md
@@ -0,0 +1,30 @@
+## Como contribuir com a AdoptOpenJDK e OpenJDK?
+
+### Como contribuir para a Adopt OpenJDK?
+
+Você pode começar a contribuir para ** AdoptOpenJDK ** primeiramente inscreva-se em uma ou mais formas de mídia social, ouvir, acompanhar a página de adoção da OpenJDK:
+
+https://java.net/projects/adoptopenjdk/pages/AdoptOpenJDK#Getting_Started
+
+E depois fazer o seguinte:
+
+- dar feedback sobre projetos OpenJDK e/ou AdoptOpenJDK
+- dar feedback sobre as novas funcionalidades/PEC que estão sendo trabalhadas
+- participar de lista de discussão (discussões sobre a AdoptOpenJDK)
+- teste os projetos disponíveis no github, compartilhe feedback sobre isso
+- contribuia para os repos do github
+- contribuia para as documentações (wiki e gitbook)
+
+### Como contribuir para o OpenJDK?
+
+AdoptOpenJDK é um canal do qual através você contribui para OpenJDK e Java (linguagem e plataforma).
+
+Ler essas seções no livro antes de fazer planos para enviar quaisquer contribuições para a base de código:
+
+- [OpenJDK: Como contribuir?](http://openjdk.java.net/contribute/)
+- [Uma antiga apresentação sobre o mesmo tópico](http://www.oracle.com/technetwork/server-storage/ts-5230-159263.pdf)
+- [Sobre o OCA - assinatura do OCA](../adopt-openjdk-getting-started/about_oca_-_signing_the_oca.md)
+- [Banco de dados de bugs do OpenJDK (JIRA)](../adopt-openjdk-getting-started/openjdk_bug_database_jira.md)
+- [Guia do desenvolvedor do OpenJDK](../intermediate-steps/openjdk_developers_guide.md)
+- [Exemplo changesets de contribuições para o OpenJDK](../intermediate-steps/example_changesets_of_contributions_into_the_openjdk.md)
+- [Patches - como criá-los e enviá-los (webrev)](../intermediate-steps/patches_-_how_to_create_and_submit_them_webrev.md)
diff --git a/pt/how-to-navigate/how_to_run_a_hackday,_how_to_prepare.md b/pt/how-to-navigate/how_to_run_a_hackday,_how_to_prepare.md
@@ -0,0 +1,19 @@
+## Como conduzir um hackday, como se preparar?
+
+- Documentação simples e consistente é uma boa ferramenta, sempre compensa - resolvemos isso criando o Kit de Introdução do OpenJDK - http://bit.ly/1NUkPWw (nosso programa de adoção)
+- Ter metas para os participantes (em tantos níveis quanto possível), categorizando os usuários em três categorias principais, iniciante, intermediário e avançado. Ver em: http://adoptopenjdk.gitbooks.io/adoptopenjdk-getting-started-kit/content/pt/how-to-navigate/how-to-navigate-and-make-progress.html (Q & A estilo documentos funciona muito bem). Objetivos significam: o que eles podem fazer em 3 horas.
+- Se você precisa redistribuir binários para permitir que os desenvolvedores configurem um ambiente, faça com que eles os baixem e os instalem uma ou duas semanas antes (offsite), que eles saibam se eles realmente fizeram isso, eles ajudarão a si mesmos e aos outros também. Sempre respeitoso e consciente do tempo das outras pessoas.
+- Também levar os binários para distribuir em pendrive ou pelo menos, em um par de unidades portáteis HDD. No caso do seu ambiente, talvez você queira torná-lo disponível através de imagens VM ou Docker que eles possam copiar e carregar. Ou scripts equivalentes para os desenvolvedores mais avançados para executá-los em casa.
+- Uma coisa que aprendemos com a experiência, certifique-se de que seus distribuíveis são acessíveis para todas as três plataformas (Windows, Linux e MacOS), resolvemos formatando os nossos portáteis em três tipos de partições e também formatando uma boa quantidade de pendrives da mesma forma. Se você estiver usando pendrive utilize os mais rápidos 3.0 com uma capacidade de pelo menos 32GB.
+- Alternativamente, iniciar um servidor de arquivos interno rápido com binários e instruções sobre como proceder (isso pode se dar de qualquer forma, mas é uma alternativa), de onde todos podem se conectar e baixar.
+- Os participantes também podem ajudar a distribuir os binários para acelerar o processo.
+- Preparação é a "chave", com grandes número sde pessoas muitas coisas podem dar errado, mas melhor preparado você conseguirá minimizar as falhas.
+- Você precisará perguntar e descobrir quem são os desenvolvedores mais e menos experiêntes no dia.
+- Além disso, se você tem um ou mais desenvolvedores que não puderam obter a configuração necessária
+- Coloque-os junto com outros que conseguiram fazer isso em casa.
+- Ter algo pronto de antemão para aqueles que não podem assistir ou aqueles que não puderam obter a sua instalação no tempo ou não puderam obter o ambiente para o trabalho - nosso guia de adoção é um bom exemplo disso.
+- Pense no que você pode fazer para atender aos desenvolvedores no modo offline - wifi ou internet podem parar de funcionar por várias razões, você pode configurar sua própria rede interna nesse caso, este pode ser um plano de fall-back.
+- Pense em tudo o que pode dar errado e priorizá-los, ver como você pode resolver e o que você não pode.
+- Entrar em um canal de IRC ou criar um google doc para reunir feedback dos desenvolvedores (ou ambos) - isso vai ajudar todos aqueles que estão assistindo a apoiarem uns aos outros.
+- Todas estas são idéias que pegamos ao executar hackdays para a Adopt OpenJDK, você não tem que fazer tudo isso, mas esteja preparado. Muitas vezes os desenvolvedores vêm despreparados, não trazem máquinas, então você precisará gerenciar esses casos, então se você estiver preparado, faça um diagrama de fluxo ou mapa mental de todas as coisas mencionadas acima e ver quais te ajudarão a resolver, criar alternativas para resolver os problemas.
+- Você não precisa cobrir tudo, apenas o que você acha que pode acontecer, a preparação é a chave.