<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Felipe Arenales Santos on Medium]]></title>
        <description><![CDATA[Stories by Felipe Arenales Santos on Medium]]></description>
        <link>https://medium.com/@felipe.arenales?source=rss-96484bab8367------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*ZnPRUQaaOT6rhucN.jpg</url>
            <title>Stories by Felipe Arenales Santos on Medium</title>
            <link>https://medium.com/@felipe.arenales?source=rss-96484bab8367------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 12:38:23 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@felipe.arenales/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[azk v0.17.0: talk to us]]></title>
            <link>https://medium.com/azuki-news/azk-v0-17-0-talk-to-us-66e9a53d97ec?source=rss-96484bab8367------2</link>
            <guid isPermaLink="false">https://medium.com/p/66e9a53d97ec</guid>
            <category><![CDATA[azk]]></category>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[containers]]></category>
            <dc:creator><![CDATA[Felipe Arenales Santos]]></dc:creator>
            <pubDate>Tue, 23 Feb 2016 19:32:02 GMT</pubDate>
            <atom:updated>2016-02-23T19:39:58.767Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WpQCUgcKpa3g45JuIHYdCg.jpeg" /><figcaption>“what seems to be the problem?”</figcaption></figure><p>Para ler a versão em Português, <a href="http://to.azk.io/v0-17-0_release_pt-BR">clique aqui</a>.</p><p>The first new <strong>azk </strong>version of the year is out!</p><h3>Azuki CI on Twitter</h3><p>azk v0.17.0 released : changelog http://to.azk.io/azk_v0-17-0 : upgrade instructions http://to.azk.io/howto_upgrade_azk ...</p><p>It took us some time but it was for a good reason (which will ultimately have a positive impact on our job with the next releases).</p><p>The main new feature of this one (<a href="http://to.azk.io/azk_v0-17-0">version <strong>0.17.0</strong></a>) is an automatic crash report system for whenever something goes wrong in <strong>azk</strong>.</p><p>With your permission, <strong>azk </strong>will send us back this information plus some additional data such as hardware and software configuration sets in which <strong>azk </strong>is being operated.</p><p>We already provide regular support channels and they have been well in demand lately (which is great):</p><ul><li><a href="https://gitter.im/azukiapp/azk">Chat</a></li><li><a href="https://github.com/azukiapp/azk/issues">GitHub issues</a></li></ul><p>However, not all users go there to talk to us and even those many who go won’t share absolutely every single crash or bug they experience.</p><p>The new crash report system will give breadth and depth to our awareness of everything that must be fixed or improved (and we’ll be able to prioritize it all according to the recurrence of issues).</p><p>Accordingly, the metadata accompanying the errors reported will give us insight about new features and their priority for <strong>azk</strong>.</p><p>Our roadmap will be clearer now and more attuned to real use scenarios.</p><p><em>Bonus round: </em>you’ll also have the option to inform an e-mail address to be associated to your reported errors (you can remove your e-mail anytime you want to — <a href="http://docs.azk.io/en/reference/cli/config.html">learn how</a>).</p><p><em>Spoiler alert</em>: <strong>azk </strong><em>core team </em>at Azuki will send you solutions to those errors as soon as we find them (even if you never ask our help directly).</p><p>We’ll try to address every error we get, but at first we’ll have to focus on the most critical and urgent ones.</p><p>And <strong>azk </strong>will still remain free even after this release? Yep ;)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/672/1*4z7heMzidqbnltz6nDHZpg.jpeg" /><figcaption>&quot;sweet, dude…&quot;</figcaption></figure><p>Another important change regards the <em>command </em>property in Azkfile.</p><p>Previously, that property should be used as a <em>String</em> which required <strong>azk </strong>to manipulate it to scape characters such as quotation marks and that made the whole process a bit error-prone.</p><p>In this new version, <strong>azk </strong>uses <em>Array </em>with commands and their arguments when starting a system. The <em>Array </em>format is more robust and more compatible with the Docker API.</p><p>Using <em>String </em>will still work (for retrocompatibility reasons), but we strongly recommend that you change your Azkfiles <em>commands</em> to <em>Array. </em>For example:</p><p>Before:</p><pre>command:<em> </em>&#39;bundle exec rackup config.ru --port $HTTP_PORT&#39;</pre><p>Now:</p><pre>command: [&#39;bundle&#39;, &#39;exec&#39;, &#39;rackup&#39;, &#39;config.ru&#39;, &#39;--port&#39;, &#39;$HTTP_PORT&#39;],</pre><p>As always, there are many other fixes and improvements in <strong>azk v0.17.0</strong>. Check the <a href="http://to.azk.io/azk_v0-17-0">changelog</a> for a complete list of them.</p><p>Special thanks to our friends for their <em>pull requests </em>included in this version of <strong>azk</strong>:</p><ul><li><a href="https://github.com/lucas-macedo">Lucas Macedo</a>, for the <a href="https://github.com/azukiapp/azk/pull/560">addition of the CakePHP <em>suggestion</em></a> (<em>suggestions </em>are Azkfile templates generated by the `<em>azk init`</em> command);</li><li><a href="https://github.com/gregoriomelo">Gregório Melo</a>, who updated the <a href="https://github.com/azukiapp/azk/pull/587">persisted volume example</a> in <strong>azk </strong>docs;</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dK8hpYGcLZX9IbQ7rpaOVg.jpeg" /><figcaption>“thanks, people!”</figcaption></figure><h4>Get azk</h4><p>Follow the <a href="http://to.azk.io/install_EN">instructions here</a> to get <strong>azk </strong>via one of the supported packet managers.</p><p>You can also <a href="http://to.azk.io/v0-17-0_zip">get the zip file<strong> </strong></a>with the latest <strong>azk </strong>version and follow the <a href="http://to.azk.io/install_source-code_EN">installation directions</a>.</p><p>If you already use <strong>azk </strong>you can just follow <a href="http://docs.azk.io/en/installation/upgrading.html">these instructions</a> to upgrade to the latest version.</p><p>Code on, folks! :D<br><em>Azuki Team</em></p><h3>More about azk</h3><p>+ Site: <a href="http://azk.io/">http://azk.io</a><br>+ Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Documentation: <a href="http://docs.azk.io/">http://docs.azk.io</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=66e9a53d97ec" width="1" height="1" alt=""><hr><p><a href="https://medium.com/azuki-news/azk-v0-17-0-talk-to-us-66e9a53d97ec">azk v0.17.0: talk to us</a> was originally published in <a href="https://medium.com/azuki-news">Azuki News</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[azk v0.17.0: fala que a gente te escuta]]></title>
            <link>https://medium.com/@felipe.arenales/azk-v0-17-0-fala-que-a-gente-te-escuta-64b285a54811?source=rss-96484bab8367------2</link>
            <guid isPermaLink="false">https://medium.com/p/64b285a54811</guid>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[containers]]></category>
            <category><![CDATA[azk]]></category>
            <dc:creator><![CDATA[Felipe Arenales Santos]]></dc:creator>
            <pubDate>Tue, 23 Feb 2016 19:31:50 GMT</pubDate>
            <atom:updated>2016-02-23T19:40:21.012Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WpQCUgcKpa3g45JuIHYdCg.jpeg" /><figcaption>&quot;o que tá pegando?&quot;</figcaption></figure><p>To read the English version, <a href="http://to.azk.io/v0-17-0_release_EN">click here</a>.</p><p>A primeira nova versão deste ano do <strong>azk </strong>está no ar!</p><h3>Azuki CI on Twitter</h3><p>azk v0.17.0 released : changelog http://to.azk.io/azk_v0-17-0 : upgrade instructions http://to.azk.io/howto_upgrade_azk ...</p><p>Esta versão demorou um pouco pra sair, mas foi por um bom motivo (que vai inclusive melhorar nosso trabalho com os próximos releases).</p><p>A principal novidade deste release (<a href="http://to.azk.io/azk_v0-17-0">versão <strong>0.17.0</strong></a>)<strong> </strong>é<strong> </strong>a adição de um sistema de envio automático de relatórios de erros internos do <strong>azk</strong>.</p><p>Com a sua permissão, sempre que um desses problemas acontecer com você, ele será adicionado automaticamente a um grande banco de dados do nosso lado. Os erros virão acrescidos de informações como detalhes de configuração de hardware e software em que o <strong>azk </strong>foi usado.</p><p>Nós já temos canais de suporte super bem utilizados pelos nossos usuários e (com bons resultados) nos links abaixo:</p><ul><li><a href="https://gitter.im/azukiapp/azk/pt">Chat (pt-BR)</a></li><li><a href="https://gitter.im/azukiapp/azk">Chat (en)</a></li><li><a href="https://github.com/azukiapp/azk/issues">GitHub issues (en)</a></li></ul><p>No entanto, nem todos os usuários nos procuram por lá e mesmo aqueles muitos que nos procuram certamente não reportam absolutamente tudo.</p><p>Com o novo sistema de relatórios automáticos, teremos visibilidade mais ampla e precisa de todos os problemas que precisam de correção, já priorizados segundo sua recorrência.</p><p>Da mesma forma, aquelas informações adicionais que acompanharão os erros reportados nos darão mais insight sobre a priorização de novas funcionalidades para o <strong>azk</strong>.</p><p>Teremos um mapa melhor para as próximas versões.</p><p><em>Bonus round: </em>além da opção de envio anônimo de erros, você terá a opção de informar um endereço de e-mail a ser associado aos seus relatórios (você pode remover seu e-mail a qualquer momento – <a href="http://docs.azk.io/pt-BR/reference/cli/config.html">veja como aqui</a>).</p><p><em>Spoiler alert</em>: o <em>core team </em>do <strong>azk</strong> na Azuki enviará ao seu e-mail as soluções para os seus problemas reportados assim que as tivermos (sem que você sequer tenha precisado nos consultar).</p><p>Tentaremos solucionar todos, mas no começo certamente trataremos pelo menos daqueles mais sérios e de maior urgência.</p><p>E o <strong>azk </strong>ainda vai continuar gratuito? Yep ;)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/672/1*4z7heMzidqbnltz6nDHZpg.jpeg" /><figcaption>&quot;massa, véi… &quot;</figcaption></figure><p>Outra mudança importante é relacionada à propriedade <em>command </em>do Azkfile.</p><p>Antes, essa propriedade era usada na forma de uma <em>String</em>, o que exigia manipulação por parte do <strong>azk </strong>para escapar caracteres como aspas e tornava o processo um tanto propenso a falhas.</p><p>Nesta versão, o <strong>azk </strong>passa a adotar o uso de <em>Array </em>com os comandos e seus argumentos para iniciar um sistema. Além de ser mais robusto, o formato <em>Array </em>é mais compatível com a API do Docker.</p><p>A versão com o <em>String </em>ainda funciona (por questão de retrocompatibilidade), mas recomendamos que você altere os <em>commands</em> em seus Azkfiles para um <em>Array.</em> Por exemplo:</p><p>Antes:</p><pre>command:<em> </em>&#39;bundle exec rackup config.ru --port $HTTP_PORT&#39;</pre><p>Depois:</p><pre>command: [&#39;bundle&#39;, &#39;exec&#39;, &#39;rackup&#39;, &#39;config.ru&#39;, &#39;--port&#39;, &#39;$HTTP_PORT&#39;],</pre><p>Como de costume, diversas outras melhorias e correções também foram introduzidas com o <strong>azk v0.17.0</strong>. Confira o <a href="http://to.azk.io/azk_v0-17-0">changelog</a> para ver uma lista completa do que mudou.</p><p>Agradecimentos especiais aos colaboradores externos pelos seus<em> pull requests</em> incluídos nesta versão do <strong>azk</strong>:</p><ul><li><a href="https://github.com/lucas-macedo">Lucas Macedo</a>, que contribuiu nesta versão<strong> </strong>com a <a href="https://github.com/azukiapp/azk/pull/560">adição da<em> suggestion </em>de CakePHP</a><em> </em>(<em>suggestions </em>são templates de Azkfile geradas pelo comando`<em>azk init</em>`);</li><li><a href="https://github.com/gregoriomelo">Gregório Melo</a>, que atualizou o <a href="https://github.com/azukiapp/azk/pull/587">exemplo de volume persistido</a> na docs do <strong>azk</strong>;</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dK8hpYGcLZX9IbQ7rpaOVg.jpeg" /><figcaption>&quot;valeu, pessoal!&quot;</figcaption></figure><h4>Obtenha o azk</h4><p>Siga as <a href="http://to.azk.io/install_pt-Br_true">instruções aqui</a> para obter o <strong>azk</strong> via um dos gerenciadores de pacote suportados.</p><p>Alternativamente, você pode <a href="http://to.azk.io/v0-17-0_zip">baixar o arquivo zip</a> com a última versão do <strong>azk </strong>e seguir as <a href="http://to.azk.io/install_source-code_pt-Br">instruções de instalação</a>.</p><p>Caso você já tenha o <strong>azk </strong>instalado, basta seguir <a href="http://docs.azk.io/pt-BR/installation/upgrading.html">estas instruções</a> para atualizá-lo.</p><p>‘Bora codar, galera! :D<br><em>Time Azuki</em></p><h3>Mais sobre o azk</h3><p>+ Site: <a href="http://azk.io/">http://azk.io</a><br>+ Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Documentação: <a href="http://docs.azk.io/">http://docs.azk.io</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=64b285a54811" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[azk v0.16.0: construindo juntos]]></title>
            <link>https://medium.com/@felipe.arenales/azk-v0-16-0-construindo-juntos-ad56bb1fe57b?source=rss-96484bab8367------2</link>
            <guid isPermaLink="false">https://medium.com/p/ad56bb1fe57b</guid>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[deployment]]></category>
            <category><![CDATA[azk]]></category>
            <dc:creator><![CDATA[Felipe Arenales Santos]]></dc:creator>
            <pubDate>Wed, 28 Oct 2015 20:39:02 GMT</pubDate>
            <atom:updated>2015-10-28T20:41:25.924Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*Zd8Zwq0_CRb4sqQ4md8lxg.jpeg" /><figcaption>código aberto == esforço coletivo</figcaption></figure><p>To read the English version, <a href="http://to.azk.io/v0-16-0_release_EN">click here</a>.</p><p>O <strong>azk v0.16.0</strong> está no ar!</p><h3>Azuki CI on Twitter</h3><p>azk v0.16.0 released : changelog http://to.azk.io/azk_v0-16-0 : upgrade instructions http://to.azk.io/howto_upgrade_azk ...</p><p>Nesta versão, adicionamos dois novos comandos ao <strong>azk</strong>:</p><ul><li><strong><em>`azk deploy`</em></strong>: integra a funcionalidade de deploy com a CLI do próprio <strong>azk</strong>. Veja como era antes <a href="http://to.azk.io/DigitalOcean_0002_pt-BR">neste artigo</a><strong> </strong>que também publicamos hoje com todas as novas funcionalidades de deploy inclusas no <strong>azk</strong> <strong>v0.16.0</strong>;</li><li><strong><em>`azk open`</em></strong>: quando você executa `<em>azk start -o</em>`, o <strong>azk</strong> abre o sistema principal em uma nova aba de seu navegador assim que os sistemas estiverem operantes. Caso você não tenha usado a opção<em>`-o`</em> por qualquer motivo ou queira reabrir o sistema principal em um momento posterior, agora você pode executar <em>`azk open`</em>.</li></ul><p>Além disso, o comando <em>`azk shell`</em> foi melhorado. Anteriormente, caso a imagem de Docker utilizada declarasse um <a href="https://docs.docker.com/reference/builder/#cmd">CMD</a>, o <strong>azk </strong>não o levava em consideração ao executar o <em>shell</em>. Isso foi corrigido e a prioridade para determinação do <em>shell</em> a ser utilizado agora é (da maior para a menor):</p><ul><li>Opção <em>`--shell`</em> passada ao comando <em>`azk shell`</em> (maior prioridade);</li><li>Propriedade <em>`shell` </em>do sistema no <a href="http://to.azk.io/Azkfile-js_pt-Br">Azkfile</a>;</li><li>CMD da imagem (declarado no Dockerfile);</li><li><em>Shell</em> padrão: /bin/sh (menor prioridade).</li></ul><p>Para mais informações e cenários de uso, confira a <a href="https://github.com/azukiapp/azk/pull/534">descrição do <em>pull request</em></a>.</p><p>Como sempre, há ainda uma série de outras melhorias e correções introduzidas com o <strong>azk</strong> <strong>v0.16.0</strong><em>. </em>Confira o<strong> </strong><a href="http://to.azk.io/azk_v0-16-0"><em>changelog</em></a><strong><em> </em></strong>para ver tudo.</p><h4>Código Aberto</h4><p>Sempre dissemos aqui no blog que esperamos pelo dia em que a maior parte do código de um novo release do <strong>azk </strong>seja resultado da contribuição de colaboradores de fora do time do próprio Azuki.</p><p>Ainda não chegamos lá, mas estamos avançando.</p><p>Queremos agradecer aos colaboradores externos abaixo pelos seus<br><em>pull requests</em>,<em> </em>incluídos neste release do <strong>azk</strong>:</p><ul><li><a href="https://github.com/teodor-pripoae"><strong><em>Teodor Pripoae</em></strong></a>, pela <a href="https://github.com/azukiapp/azk/pull/526">adição de uma variável de ambiente</a> que permite ligar e desligar a verificação do status do Docker (que estava causando a parada prematura do <strong>azk agent </strong>em alguns casos);</li><li><a href="https://github.com/slobo"><strong><em>Slobodan Mišković</em></strong>,</a> pela <a href="https://github.com/azukiapp/azk/pull/527">indicação de melhoria na verificação da versão do Docker em uso</a>, que apresentava erro caso a versão do Docker em uso não respeitasse o padrão <a href="http://semver.org/">SemVer</a>;</li><li><a href="https://github.com/renanmpimentel"><strong>Renan Pimentel</strong></a>, pelas <a href="https://github.com/azukiapp/azk/pull/537">melhorias nas <em>suggestions </em>de MySQL</a> (<em>suggestions </em>são templates do código gerados pelo `<em>azk init</em>`);</li><li><a href="https://github.com/diegorv"><strong>Diego Rossini Vieira</strong></a>, por <a href="https://github.com/azukiapp/azk/pull/533">melhorias na documentação</a> dos exemplos de uso do <strong>azk</strong> com <a href="http://to.azk.io/PHP_from_scratch_pt-BR">PHP</a> e <a href="http://to.azk.io/Rails_from_scratch_pt-BR">Ruby</a><strong> </strong>e por <a href="https://github.com/azukiapp/docker-mysql/pull/1">melhorias na imagem do MySQL</a> (substituição do Ubuntu por Debian e garantia da criação automática do banco de dados).</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/859/1*gsTS9LLUCg5q7ZJYoQfzrg.png" /><figcaption>valeu, pessoal!</figcaption></figure><h4>Obtenha o azk</h4><p>Siga as <a href="http://to.azk.io/install_pt-Br_true">instruções aqui</a> para obter o <strong>azk</strong> via um dos gerenciadores de pacote suportados.</p><p>Alternativamente, você pode <a href="http://to.azk.io/v0-16-0_zip">baixar o arquivo zip</a> com a última versão do <strong>azk </strong>e seguir as <a href="http://to.azk.io/install_source-code_pt-Br">instruções de instalação</a>.</p><p>‘Bora codar e deployar, galera! :D<br><em>Time Azuki</em></p><h3>Mais sobre o azk</h3><p>+ Site: <a href="http://azk.io/">http://azk.io</a><br>+ Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Documentação: <a href="http://docs.azk.io/">http://docs.azk.io</a><br>+ Diretório de imagens criadas pelo time do <strong>azk</strong>: <a href="http://images.azk.io/">http://images.azk.io</a></p><h3>Contribua com o azk</h3><p>+ <em>“Star”</em> o <strong>azk </strong>no Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Reporte um problema: <a href="https://github.com/azukiapp/azk/issues/new">https://github.com/azukiapp/azk/issues/new</a><br>+ Ajude a resolver um problema reportado:<a href="https://github.com/azukiapp/azk/issues">https://github.com/azukiapp/azk/issues</a><br>+ Confira os sponsors do <strong>azk</strong>: <a href="http://azk.io/#sponsors">http://azk.io/#sponsors</a></p><h3>Fale com o time do azk</h3><p>+ Assine a newsletter semanal: <a href="http://www.azk.io/#newsletter">http://www.azk.io/#newsletter</a><br>+ Acompanhe o blog: <a href="https://medium.com/azuki-news">https://medium.com/azuki-news</a><br>+ Fale com nosso suporte (chat): <a href="https://gitter.im/azukiapp/azk/pt">https://gitter.im/azukiapp/azk/pt</a> (Português) e <a href="https://gitter.im/azukiapp/azk">https://gitter.im/azukiapp/azk</a> (English)<br>+ Facebook: <a href="https://www.facebook.com/azukiapp">https://www.facebook.com/azukiapp</a><br>+ Twitter: <a href="http://twitter.com/azukiapp">http://twitter.com/azukiapp</a><br>+ YouTube: <a href="https://www.youtube.com/user/Azukiapp/videos">https://www.youtube.com/user/Azukiapp/videos</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ad56bb1fe57b" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[azk v.016.0: building together]]></title>
            <link>https://medium.com/azuki-news/azk-v-016-0-building-together-8b41f455a59d?source=rss-96484bab8367------2</link>
            <guid isPermaLink="false">https://medium.com/p/8b41f455a59d</guid>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[azk]]></category>
            <category><![CDATA[deployment]]></category>
            <dc:creator><![CDATA[Felipe Arenales Santos]]></dc:creator>
            <pubDate>Wed, 28 Oct 2015 20:38:58 GMT</pubDate>
            <atom:updated>2015-12-12T09:54:41.441Z</atom:updated>
            <content:encoded><![CDATA[<h3>azk v0.16.0: building together</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*Zd8Zwq0_CRb4sqQ4md8lxg.jpeg" /><figcaption>open source == team effort</figcaption></figure><p>Para ler a versão em Português, <a href="http://to.azk.io/v0-16-0_release_pt-BR">clique aqui</a>.</p><p><strong>azk v0.16.0</strong> is available!</p><h3>Azuki CI on Twitter</h3><p>azk v0.16.0 released : changelog http://to.azk.io/azk_v0-16-0 : upgrade instructions http://to.azk.io/howto_upgrade_azk ...</p><p>For this version, we created two brand new <strong>azk </strong>commands:</p><ul><li><strong><em>`azk deploy`</em></strong>: brings <strong>azk </strong>deployment capabilities to its own CLI. Check how it was before in <a href="http://to.azk.io/DigitalOcean_0002_EN">this article</a> we’re releasing today with all the new deployment features added to <strong>azk v0.16.0</strong>;</li><li><strong><em>`azk open`</em></strong>: when you run `<em>azk start -o</em>`, <strong>azk </strong>opens the main system in a new browser tab as soon as all systems are up and running. If you didn’t use the option `-o` for any reason or if you just feel like reopening the main system in a posterior occasion, you can now run <em>`azk open`</em>.</li></ul><p>Plus, we improved the command <em>`azk shell`. </em>Previously, if a Docker image declared a <a href="https://docs.docker.com/reference/builder/#cmd">CMD</a>, <strong>azk </strong>ignored it when running the command. That’s corrected now.</p><p>The new priority criteria to select the <em>shell </em>to be will used is (from the highest to the lowest):</p><ul><li>Option <em>`--shell`</em> passed to the command <em>`azk shell` </em>(highest priority);</li><li>The system’s <em>`shell` </em>property in the <a href="http://to.azk.io/Azkfile-js_EN">Azkfile.js</a>;</li><li>Image’s CMD (declared in the Dockerfile);</li><li>Default <em>shell: </em>/bin/sh (lowest priority).</li></ul><p>Check the <a href="https://github.com/azukiapp/azk/pull/534"><em>pull request </em>description</a> for more information and use cases.</p><p>As always, there’s a roster of other improvements and corrections introduced with <strong>azk v0.16.0</strong>. Check the <a href="http://to.azk.io/azk_v0-16-0"><em>changelog</em></a><strong><em> </em></strong>to see them all.</p><h4>Open Source</h4><p>We’ve always spoken of how we look forward to the day when most of the code in a new <strong>azk </strong>release comes from contributors from outside our core team at Azuki.</p><p>We’re not there… yet. But we’re moving forward with it.</p><p>We’d like to thank our external collaborators for their <em>pull requests </em>included in this <strong>azk </strong>release:</p><ul><li><a href="https://github.com/teodor-pripoae"><strong><em>Teodor Pripoae</em></strong></a>, for <a href="https://github.com/azukiapp/azk/pull/526">adding an environment variable</a> that allows for turning Docker’s status verification <em>on</em> and <em>off </em>(which caused <strong>azk agent </strong>to prematurely stop in some cases);</li><li><a href="https://github.com/slobo"><strong><em>Slobodan Mišković</em></strong>,</a> for <a href="https://github.com/azukiapp/azk/pull/527">pointing an improvement for the verification of the Docker version in use</a>, which previously resulted in error if the version in use didn’t follow the <a href="http://semver.org/">SemVer</a> standard;</li><li><a href="https://github.com/renanmpimentel"><strong>Renan Pimentel</strong></a>, for <a href="https://github.com/azukiapp/azk/pull/537">improving MySQL <em>suggestions</em></a><em> </em>(<em>suggestions </em>are code templates generated by `<em>azk init</em>`);</li><li><a href="https://github.com/diegorv"><strong>Diego Rossini Vieira</strong></a>, for <a href="https://github.com/azukiapp/azk/pull/533">documentation improvements</a> about using <strong>azk </strong>with <a href="http://to.azk.io/PHP_from_scratch_EN">PHP</a><strong> </strong>and <a href="http://to.azk.io/Rails_from_scratch_EN">Ruby</a><strong> </strong>and for <a href="https://github.com/azukiapp/docker-mysql/pull/1">MySQL image improvements</a> (replacing Ubuntu with Debian and assuring the automatic creation of the database).</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/859/1*gsTS9LLUCg5q7ZJYoQfzrg.png" /><figcaption>thank you so much, folks!</figcaption></figure><h4>Get azk</h4><p>Follow the <a href="http://to.azk.io/install_EN">instructions here</a> to get <strong>azk </strong>via one of the supported packet managers.</p><p>You can also <a href="http://to.azk.io/v0-16-0_zip">get the zip file</a><strong> </strong>with the latest <strong>azk </strong>version and follow the <a href="http://to.azk.io/install_source-code_EN">installation directions</a>.</p><p>Just code &amp; deploy, people! :D<br><em>Azuki Team</em></p><h3>More about azk</h3><p>+ Site: <a href="http://azk.io/">http://azk.io</a><br>+ Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Documentation: <a href="http://docs.azk.io/">http://docs.azk.io</a><br>+ Images directory created by the <strong>azk </strong>team: <a href="http://images.azk.io/">http://images.azk.io</a></p><h3>Contribute to azk</h3><p>+ <em>Star</em> <strong>azk </strong>on<strong> </strong>Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Report an issue: <a href="https://github.com/azukiapp/azk/issues/new">https://github.com/azukiapp/azk/issues/new</a><br>+ Help solving a reported issue: <a href="https://github.com/azukiapp/azk/issues">https://github.com/azukiapp/azk/issues</a><br>+ Check out our awesome sponsors: <a href="http://azk.io/#sponsors">http://azk.io/#sponsors</a></p><h3>Stay in touch with the azk team</h3><p>+ Sign up the weekly digest: <a href="http://www.azk.io/#newsletter">http://www.azk.io/#newsletter</a><br>+ Follow the blog: <a href="https://medium.com/azuki-news">https://medium.com/azuki-news</a><br>+ Talk to our support (chat): <a href="https://gitter.im/azukiapp/azk">https://gitter.im/azukiapp/azk</a> (English) and <a href="https://gitter.im/azukiapp/azk/pt">https://gitter.im/azukiapp/azk/pt</a> (Português)<br>+ Facebook: <a href="https://www.facebook.com/azukiapp">https://www.facebook.com/azukiapp</a><br>+ Twitter: <a href="http://twitter.com/azukiapp">http://twitter.com/azukiapp</a><br>+ YouTube: <a href="https://www.youtube.com/user/Azukiapp/videos">https://www.youtube.com/user/Azukiapp/videos</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8b41f455a59d" width="1" height="1" alt=""><hr><p><a href="https://medium.com/azuki-news/azk-v-016-0-building-together-8b41f455a59d">azk v.016.0: building together</a> was originally published in <a href="https://medium.com/azuki-news">Azuki News</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[azk deploy: Mark II]]></title>
            <link>https://medium.com/azuki-news/azk-deploy-mark-ii-2a79de7c7c9c?source=rss-96484bab8367------2</link>
            <guid isPermaLink="false">https://medium.com/p/2a79de7c7c9c</guid>
            <category><![CDATA[azk]]></category>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[deployment]]></category>
            <dc:creator><![CDATA[Felipe Arenales Santos]]></dc:creator>
            <pubDate>Wed, 28 Oct 2015 20:21:03 GMT</pubDate>
            <atom:updated>2015-10-30T03:19:56.264Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5EGgQd-RyIJAY_oNtg3UAg.png" /><figcaption>a classic is great, but…</figcaption></figure><p>Para ler a versão em Português, <a href="http://to.azk.io/DigitalOcean_0002_pt-BR">clique aqui</a>.</p><p>Hi there!</p><p>In a previous article, we demonstrated <a href="http://to.azk.io/DigitalOcean_0001_EN">how to use <strong>azk </strong>to deploy your application to DigitalOcean</a>.</p><p>At that time, the only command <strong>azk </strong>offered to that purpose was:</p><pre>$ azk shell deploy</pre><p>That was an effective and elegant solution. However, it was just a first draft. At the end of that article, we listed some of the improvements we knew we had to make.</p><p>We are releasing today <a href="http://to.azk.io/v0-16-0_release_EN"><strong>azk v.0.16.0</strong></a>, with several deployment improvements.</p><p>Among them, we highlight features such as <strong>rollbacks </strong>(returning the application to previous states) and <strong>performance optimizations </strong>that make the deployment much more robust and faster.</p><p>For several reasons we mentioned before, we chose to stick to <a href="https://www.digitalocean.com/">DigitalOcean</a> as our deployment option for <strong>azk</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*e7WRE0BoSCfdLuifEedgUw.jpeg" /><figcaption>…there’s always room for improvement ;)</figcaption></figure><p>From now on, the main command to deploy with <strong>azk </strong>is:</p><pre>$ azk deploy</pre><p>The previous command still works, but the new one is simpler and supports new features in the form of arguments (parameter <em>[args]</em>).</p><pre>$ azk deploy [args]</pre><p>Here’s the complete list of arguments:</p><ul><li><strong>full</strong>: forces the <a href="https://www.digitalocean.com/help/technical/general/">droplet</a> reconfiguration (it’s the standard for the first deployment of an application anyway);</li><li><strong>fast</strong>: deploys the application without configuring the droplet (it’s the standard for all following deployments of that same application);</li><li><strong>restart</strong>: restarts the application in the droplet;</li><li><strong>versions</strong>: lists every version of the application that has been deployed to the droplet (informs version and commit title of each version);</li><li><strong>rollback</strong>: turns the application back to the closest previous version. This parameter supports another one <strong>[ref]</strong>, that points to another version that is not the closest previous. The <em>[ref] </em>parameter can be a version number (e.g. <em>v4</em>), as the command <em>`azk deploy versions` </em>returns. It can also be a <em>git</em> reference (<em>branch, tag </em>or <em>commit </em>ID). The application can be taken to previous and posterior versions (if there is any in each case);</li><li><strong>ssh</strong>: creates a SSH connection to the droplet where the application is deployed;</li><li><strong>shell</strong>: opens a terminal from within the container carrying the deployment <em>system </em>(still on the developer’s local machine);</li><li><strong>clear-cache</strong>: clears all deployment configuration data stored in cache;</li><li><strong>help</strong>: shows help message with deployment instructions.</li></ul><p>Another important new feature is the use of a <strong><em>persistent folder </em></strong>on<strong><em> </em></strong>the deployment <em>system </em>in the application’s <a href="http://to.azk.io/Azkfile-js_EN">Azkfile</a>. This folder (featured on line 8 of the excerpt below) is NOT mandatory. However it allows for storing data that will make following deployments of that same application run <em>much </em>faster.</p><p>The deployment system in the Azkfile should be as below:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/437094f32098b20b428144792ba93ddb/href">https://medium.com/media/437094f32098b20b428144792ba93ddb/href</a></iframe><blockquote><strong>Important</strong>: by convention, <strong>azk </strong>assumes that your deployment system will always be called <strong>“deploy”</strong>. Using any other name will result in malfunctioning.</blockquote><h4>Upgrades</h4><p>Before we move forward, you must make the following upgrades:</p><blockquote>1. In case you have already deployed an application using <strong>azk, </strong>upgrade the deployment image. For that, just run:</blockquote><pre>$ adocker pull azukiapp/deploy-digitalocean</pre><blockquote>2. You’ll need <strong>azk v0.16.0 </strong>for the demo ahead (see below):</blockquote><h3>Azuki CI on Twitter</h3><p>azk v0.16.0 released : changelog http://to.azk.io/azk_v0-16-0 : upgrade instructions http://to.azk.io/howto_upgrade_azk ...</p><h4>Example of use</h4><p>The following is a short tutorial illustrating the use of some of the new features to deploy to DigitalOcean using <strong>azk</strong>.</p><p>The initial setup (creating an access token to DigitalOcean’s API and generating SSH keys in case you still don’t have them on your machine) still is the same we presented in <a href="http://to.azk.io/DigitalOcean_0001_EN">our inaugural article about deploying with <strong>azk</strong></a>.</p><p><strong>1 - The first deployment</strong></p><p>Assuming we have an application and its Azkfile (to which the deployment <em>system </em>has been<em> </em>added), let’s now add the access token to DigitalOcean’s API to our <em>.env </em>file:</p><pre>$ echo DEPLOY_API_TOKEN=PASTE_YOUR_TOKEN_HERE &gt;&gt; .env</pre><p>Then, just run:</p><pre>$ azk deploy</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ccTJZOhJ4pwRd4aQSMpJWg.png" /></figure><p><strong>azk </strong>will create and configure your <a href="https://www.digitalocean.com/help/technical/general/"><em>droplet</em></a><em> </em>on DigitalOcean and will send all your application’s files to it. It may take a while the first time (10 min.), but the following deployments of the same application will run much faster (less than 30s!).</p><p><strong>2 - Deploying a new version</strong></p><p>In order to deploy a new version of your application, all you have to do is <em>commit </em>the new changes to <em>git </em>(files are sent to the droplet via <em>`git push`) </em>and then just run the same command as before:</p><pre>$ azk deploy</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*V2G5TKKX0wxdUCu5SuWkaA.png" /></figure><p>This time, <strong>azk </strong>already knows the droplet is set up and ready to receive the application. Thus, it just sends the files and restarts <strong>azk </strong>on the droplet.</p><p>It’s <em>FAST!</em></p><p><strong>3 - Listing all available versions</strong></p><p>Run the command below to list every application version that has been deployed and its correspondent commit messages:</p><pre>$ azk deploy versions</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*PiQtWsNbMkLqaLhgfbdwRg.png" /><figcaption>the arrow “-&gt;” indicates the version in use</figcaption></figure><p><strong>4 - Rollback to a previous state</strong></p><p>To rollback your application to the closest previous version deployed (<em>v1 </em>in this case), run:</p><pre>$ azk deploy rollback</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/969/1*tJmAscGhg0eVUDvxxAOnXw.png" /></figure><p>Now, when we list the versions we get:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*AN7rWBCj1toVXe5TgtT9MQ.png" /><figcaption>the arrow “-&gt;” moved to the “v1” version</figcaption></figure><p>Finally, if we want to move forward to <strong>v2 </strong>again, we must run:</p><pre>$ azk deploy rollback v2</pre><h4>Next steps</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IVruvfuzXAkEPV1ujH-Mfg.jpeg" /><figcaption>“roads?”</figcaption></figure><p><strong>azk </strong>is not “just” for setting up development environments on your local machine. We want to make it powerful enough to be your first choice to deploy your applications.</p><p>We know there’s a lot we must do before that.</p><p>We’re just getting started. ;)</p><p><em>To be continued…<br>Azuki Team</em></p><h3>More about azk</h3><p>+ Site: <a href="http://azk.io/">http://azk.io</a><br>+ Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Documentation: <a href="http://docs.azk.io/">http://docs.azk.io</a><br>+ Images directory created by the <strong>azk </strong>team: <a href="http://images.azk.io/">http://images.azk.io</a></p><h3>Contribute to azk</h3><p>+ <em>Star</em> <strong>azk </strong>on<strong> </strong>Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Report an issue: <a href="https://github.com/azukiapp/azk/issues/new">https://github.com/azukiapp/azk/issues/new</a><br>+ Help solving a reported issue: <a href="https://github.com/azukiapp/azk/issues">https://github.com/azukiapp/azk/issues</a><br>+ Check out our awesome sponsors: <a href="http://azk.io/#sponsors">http://azk.io/#sponsors</a></p><h3>Stay in touch with the azk team</h3><p>+ Sign up the weekly digest: <a href="http://www.azk.io/#newsletter">http://www.azk.io/#newsletter</a><br>+ Follow the blog: <a href="https://medium.com/azuki-news">https://medium.com/azuki-news</a><br>+ Talk to our support (chat): <a href="https://gitter.im/azukiapp/azk">https://gitter.im/azukiapp/azk</a> (English) and <a href="https://gitter.im/azukiapp/azk/pt">https://gitter.im/azukiapp/azk/pt</a> (Português)<br>+ Facebook: <a href="https://www.facebook.com/azukiapp">https://www.facebook.com/azukiapp</a><br>+ Twitter: <a href="http://twitter.com/azukiapp">http://twitter.com/azukiapp</a><br>+ YouTube: <a href="https://www.youtube.com/user/Azukiapp/videos">https://www.youtube.com/user/Azukiapp/videos</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2a79de7c7c9c" width="1" height="1" alt=""><hr><p><a href="https://medium.com/azuki-news/azk-deploy-mark-ii-2a79de7c7c9c">azk deploy: Mark II</a> was originally published in <a href="https://medium.com/azuki-news">Azuki News</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[azk deploy: Mark II]]></title>
            <link>https://medium.com/@felipe.arenales/azk-deploy-mark-ii-60bc432fb2c0?source=rss-96484bab8367------2</link>
            <guid isPermaLink="false">https://medium.com/p/60bc432fb2c0</guid>
            <category><![CDATA[deployment]]></category>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[azk]]></category>
            <dc:creator><![CDATA[Felipe Arenales Santos]]></dc:creator>
            <pubDate>Wed, 28 Oct 2015 20:21:00 GMT</pubDate>
            <atom:updated>2015-10-28T20:45:53.369Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5EGgQd-RyIJAY_oNtg3UAg.png" /><figcaption>clássico é clássico, mas…</figcaption></figure><p>To read the English version, <a href="http://to.azk.io/DigitalOcean_0002_EN">click here</a>.</p><p>Olá,</p><p>Em um artigo anterior, mostramos <a href="http://to.azk.io/DigitalOcean_0001_pt-BR">como utilizar o <strong>azk</strong> para realizar o deploy de sua aplicação na DigitalOcean</a>.</p><p>Naquela ocasião, o único comando oferecido pelo <strong>azk </strong>para deploy era:</p><pre>$ azk shell deploy</pre><p>Embora essa fosse uma solução eficaz e elegante, ela ainda era uma primeira iteração. Listamos ao fim daquele artigo alguns exemplos de melhorias que faríamos em seguida.</p><p>Estamos lançando hoje o <a href="http://to.azk.io/v0-16-0_release_pt-BR"><strong>azk v0.16.0</strong></a>, com várias melhorias de deploy.</p><p>Dentre elas, destacamos recursos como <strong>rollbacks</strong> (possibilidade de retornar a aplicação a estados anteriores) e <strong>otimizações de performance</strong>, que tornam o deploy mais rápido e robusto.</p><p>Por vários motivos que destacamos antes, continuamos optando pela <a href="https://www.digitalocean.com/">DigitalOcean</a> como opção de deploy para o <strong>azk</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*e7WRE0BoSCfdLuifEedgUw.jpeg" /><figcaption>…sempre dá pra melhorar ;)</figcaption></figure><p>A partir de agora, o comando principal de deploy do <strong>azk </strong>passa a ser:</p><pre>$ azk deploy</pre><p>O comando anterior continua funcionando, mas além de ser mais simples, o novo comando suporta novas funcionalidades na forma de argumentos (parâmetro <em>[args]</em>).</p><pre>$ azk deploy [args]</pre><p>São eles:</p><ul><li><strong>full</strong>: força a reconfiguração do <a href="https://www.digitalocean.com/help/technical/general/">droplet</a> (é o padrão para o primeiro deploy de uma aplicação);</li><li><strong>fast</strong>: faz o deploy da aplicação sem configurar o droplet (é o padrão para os deploys seguintes de uma mesma aplicação);</li><li><strong>restart</strong>: reinicia a aplicação no droplet;</li><li><strong>versions</strong>: lista todas as versões da aplicação que já tiveram deploy no droplet (informa as versões e o título do commit em cada versão correspondente);</li><li><strong>rollback</strong>: reverte a aplicação para a versão imediatamente anterior. Este parâmetro também suporta, por sua vez, o parâmetro <strong>[ref], </strong>que permite a indicação de uma versão diferente da imediatamente anterior. O parâmetro <em>[ref] </em>pode ser um número de versão (por exemplo, <em>v4</em>), como retornado pelo comando <em>`azk deploy versions`, </em>ou uma referência do git (identificador de um <em>branch</em>, <em>tag </em>ou<em> commit</em>). A aplicação pode ser alterada para versões anteriores como também para posteriores (caso haja alguma em qualquer um dos casos);</li><li><strong>ssh</strong>: cria uma conexão SSH com o droplet de destino da aplicação;</li><li><strong>shell</strong>: abre um terminal de dentro do container contendo o <em>system </em>de deploy (ainda na máquina local do usuário);</li><li><strong>clear-cache</strong>: limpa os dados de configuração do deploy armazenados em cache;</li><li><strong>help</strong>: exibe uma mensagem de ajuda com instruções do deploy.</li></ul><p>Outra mudança importante é a introdução de uma <strong><em>persistent folder</em></strong><em> </em>para o <em>system</em> de deploy no <a href="http://to.azk.io/Azkfile-js_pt-Br">Azkfile</a> da aplicação. Essa pasta (representada na linha 8 do trecho abaixo) não é obrigatória, mas permite ao processo guardar informações que farão as execuções seguintes do deploy da mesma aplicação <em>muito</em> mais rápidas.</p><p>O sistema de deploy no Azkfile deve ficar como abaixo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/437094f32098b20b428144792ba93ddb/href">https://medium.com/media/437094f32098b20b428144792ba93ddb/href</a></iframe><blockquote><strong>Importante</strong>: por convenção, o <strong>azk </strong>assume que seu &quot;system&quot; de deploy será sempre chamado &quot;<strong>deploy&quot;</strong>. O uso de qualquer outro nome resultará em mau funcionamento da ferramenta.</blockquote><h4>Upgrades</h4><p>Antes de avançarmos, é importante que você faça as atualizações abaixo:</p><blockquote>1. Caso você já tenha utilizado o deploy do <strong>azk</strong> anteriormente, atualize a imagem de deploy antes de continuar. Para isso, execute:</blockquote><pre>$ adocker pull azukiapp/deploy-digitalocean</pre><blockquote>2. Você precisará da versão 0.16.0 do <strong>azk </strong>para a demonstração a seguir (vide abaixo):</blockquote><h3>Azuki CI on Twitter</h3><p>azk v0.16.0 released : changelog http://to.azk.io/azk_v0-16-0 : upgrade instructions http://to.azk.io/howto_upgrade_azk ...</p><h4>Exemplo de utilização</h4><p>Apresentamos a seguir um pequeno tutorial ilustrando o uso de algumas das novas funcionalidades de deploy para a DigitalOcean utilizando o <strong>azk</strong>.</p><p>A configuração inicial (criação do token de acesso à API da DigitalOcean e geração das chaves SSH, se você ainda não as tiver em sua máquina) ainda é a mesma apresentada em <a href="http://to.azk.io/DigitalOcean_0001_pt-BR">nosso artigo inicial de deploy usando o <strong>azk</strong></a>.</p><p><strong>1) O primeiro deploy</strong></p><p>Partindo do princípio de que temos uma aplicação com o <em>system </em>de deploy adicionado ao seu Azkfile, vamos primeiro adicionar o token de acesso à API da DigitalOcean ao nosso arquivo <em>.env.</em></p><pre>$ echo DEPLOY_API_TOKEN=COLOQUE_SEU_TOKEN_AQUI &gt;&gt; .env</pre><p>Agora, basta executarmos o comando:</p><pre>$ azk deploy</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ccTJZOhJ4pwRd4aQSMpJWg.png" /></figure><p>O <strong>azk</strong> criará e configurará o <a href="https://www.digitalocean.com/help/technical/general/">droplet</a> na DigitalOcean e subirá todos os arquivos da sua aplicação. A primeira vez pode demorar um pouco (10 min.), mas novos deploys dessa mesma aplicação serão muito mais rápidos (menos de 30s!).</p><p><strong>2) Subindo uma nova versão</strong></p><p>Para subir uma nova versão de sua aplicação, basta <em>fazer o commit</em> de uma alteração no <em>git </em>(a transferência de arquivos para o droplet se dá via `<em>git push`</em>) e executar o mesmo comando anterior:</p><pre>$ azk deploy</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*V2G5TKKX0wxdUCu5SuWkaA.png" /></figure><p>Dessa vez, o <strong>azk </strong>já saberá que o droplet já está configurado e pronto pra receber a aplicação. Assim, ele apenas fará a transferência dos arquivos e a reinicialização do <strong>azk </strong>no droplet.</p><p>É <em>MUITO</em> rápido!</p><p><strong>3) Listando as versões disponíveis</strong></p><p>Para listar as versões da aplicação que já passaram pelo deploy e suas respectivas mensagens de commit, basta executarmos:</p><pre>$ azk deploy versions</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*XoUGL9vHIhuJnvjrdf-5QA.png" /><figcaption>a seta “-&gt;” indica a versão em execução no momento</figcaption></figure><p><strong>4) Revertendo a aplicação para uma versão anterior</strong></p><p>Se quisermos reverter a aplicação para a versão imediatamente anterior (<em>v1</em>, na imagem anterior), executamos:</p><pre>$ azk deploy rollback</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/969/1*tJmAscGhg0eVUDvxxAOnXw.png" /></figure><p>Se checarmos as versões em seguida, obteremos:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*76aIVsBqZJfUSFRopEu3CA.png" /><figcaption>observe que a seta “-&gt;” agora indica a versão anterior “v1”</figcaption></figure><p>Por fim, se quisermos avançar novamente para a <strong>v2</strong>, o comando a ser executado é:</p><pre>$ azk deploy rollback v2</pre><h4>Próximos passos</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IVruvfuzXAkEPV1ujH-Mfg.jpeg" /><figcaption>&quot;roads?&quot;</figcaption></figure><p>Além de uma ferramenta poderosa para a orquestração de ambientes de desenvolvimento na sua máquina local, queremos tornar o <strong>azk </strong>sua<strong> </strong>ferramenta de escolha para o deploy.</p><p>Sabemos que ainda há muito a ser feito para isso.</p><p>Ainda estamos só começando. ;)</p><p><em>To be continued…<br>Time Azuki</em></p><h3>Mais sobre o azk</h3><p>+ Site: <a href="http://azk.io/">http://azk.io</a><br>+ Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Documentação: <a href="http://docs.azk.io/">http://docs.azk.io</a><br>+ Diretório de imagens criadas pelo time do <strong>azk</strong>: <a href="http://images.azk.io/">http://images.azk.io</a></p><h3>Contribua com o azk</h3><p>+ <em>“Star”</em> o <strong>azk </strong>no Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Reporte um problema: <a href="https://github.com/azukiapp/azk/issues/new">https://github.com/azukiapp/azk/issues/new</a><br>+ Ajude a resolver um problema reportado:<a href="https://github.com/azukiapp/azk/issues">https://github.com/azukiapp/azk/issues</a><br>+ Confira os sponsors do <strong>azk</strong>: <a href="http://azk.io/#sponsors">http://azk.io/#sponsors</a></p><h3>Fale com o time do azk</h3><p>+ Assine a newsletter semanal: <a href="http://www.azk.io/#newsletter">http://www.azk.io/#newsletter</a><br>+ Acompanhe o blog: <a href="https://medium.com/azuki-news">https://medium.com/azuki-news</a><br>+ Fale com nosso suporte (chat): <a href="https://gitter.im/azukiapp/azk/pt">https://gitter.im/azukiapp/azk/pt</a> (Português) e <a href="https://gitter.im/azukiapp/azk">https://gitter.im/azukiapp/azk</a> (English)<br>+ Facebook: <a href="https://www.facebook.com/azukiapp">https://www.facebook.com/azukiapp</a><br>+ Twitter: <a href="http://twitter.com/azukiapp">http://twitter.com/azukiapp</a><br>+ YouTube: <a href="https://www.youtube.com/user/Azukiapp/videos">https://www.youtube.com/user/Azukiapp/videos</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=60bc432fb2c0" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Azkfile.js: your user deserves it (and so do you!)]]></title>
            <link>https://medium.com/azuki-news/azkfile-js-your-user-deserves-it-and-so-do-you-a554ae6abfbf?source=rss-96484bab8367------2</link>
            <guid isPermaLink="false">https://medium.com/p/a554ae6abfbf</guid>
            <category><![CDATA[azk]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[github]]></category>
            <dc:creator><![CDATA[Felipe Arenales Santos]]></dc:creator>
            <pubDate>Fri, 25 Sep 2015 15:35:47 GMT</pubDate>
            <atom:updated>2015-10-01T11:40:41.730Z</atom:updated>
            <content:encoded><![CDATA[<h3>Azkfile.js: your users deserve it (and so do you!)</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/700/1*59Reab1ccqjYvFAmu186LA.jpeg" /><figcaption>every work of engineering begins with the blueprints</figcaption></figure><p>Para ler a versão em Português, <a href="http://to.azk.io/Azkfile-js_Why_0001_pt-BR">clique aqui</a>.</p><p><a href="http://to.azk.io/run-release_EN">Last week, we introduced</a> the “<strong><em>Run Project”</em> button</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/183/1*wdGvZ6DzzBVInd2au04Zbw.png" /></figure><p>As we said before:</p><p><em>“</em><strong><em>Run Project” </em></strong><em>is the “play” button for GitHub</em></p><p>Click the button and the code you just saw on that <a href="https://github.com/">GitHub</a> repository will be running (<em>safely!</em>) on your local machine in just a few minutes.</p><p><a href="http://to.azk.io/run-howto_0001_EN">Check out the tutorial</a> for a detailed demonstration.</p><p>For that, you’ll need to install <strong>azk</strong>. <a href="http://to.azk.io/welcome_EN">As we have previously explained</a>:</p><p><strong><em>azk</em></strong><em> is a development environment orchestrator</em></p><p><strong>azk </strong>can be used directly even in projects without <strong><em>“Run Project” </em></strong>(or even outside GitHub).</p><p>We built <strong>azk </strong>for <em>individual developers</em> and <em>small teams</em>.</p><p>It doesn’t matter if we’re talking about <a href="http://to.azk.io/Rails-install_EN">new projects built from scratch</a> or <a href="http://to.azk.io/Selfstarter_EN">previously existing applications</a>, <strong>azk </strong>automatically installs and configures the development environments for you.</p><p><strong>azk </strong>can be operated through a CLI (<em>command line interface</em>) and <em>Azkfile.js.</em></p><p>What is an <em>Azkfile.js</em> anyway?</p><h3>Owner’s manual</h3><p><strong><em>Azkfile.js</em></strong><em> is an application’s “owner’s manual” for </em><strong><em>azk</em></strong></p><p>It’s a simple manifest file that lists the architecture components of an application and briefly describes the relationships between them.</p><p>It informs <strong>azk </strong>about the architecture so that it can <em>provision the environment</em> and <em>run the required systems</em>.</p><p>As its extension indicates, <em>Azkfile.js </em>is based on JavaScript, a popular, simple and easy to learn syntax. Anyway, using an <em>Azkfile.js </em>with <strong>azk </strong>doesn’t require any previous knowledge of it.</p><p>Check this example of <em>Azkfile.js </em>for <a href="http://to.azk.io/run-project_gallery_Stringer">a real application</a>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b76f621ff90ea6a9b37f24fbb22b0607/href">https://medium.com/media/b76f621ff90ea6a9b37f24fbb22b0607/href</a></iframe><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lNrddbSwroPc8aAgdTYfzw.png" /><figcaption><em>Azkfile.js</em> in action with <strong>azk: </strong>“What kind of sorcery was that?”</figcaption></figure><h3>How to create</h3><p>There’s a <a href="http://to.azk.io/Azkfile-js_EN">section about <em>Azkfile.js</em></a><em> </em>on <strong>azk</strong>’s<strong> </strong>documentation with a brief but thorough explanation about how to create one for your application.</p><p>The <a href="http://to.azk.io/Azkfile-js_reference_EN">reference section</a> lists every parameter supported by <em>Azkfile.js </em>and the proper way to use them.</p><p>You may compose an entire <em>Azkfile.js </em>from scratch on your own, but you don’t have to. Instead, you can use the <em>`azk init`</em>command on <strong>azk.</strong></p><p>It can automatically create most of the manifest file for you. From this point on, you can make the adjustments and additions you consider necessary. Learn more about <em>`azk init`</em> <a href="http://to.azk.io/azk-init_0001_EN">on this section of our documentation.</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*brokhL5LIcCPMnBO-1FWDA.png" /><figcaption>$ azk init</figcaption></figure><p>Finally, <a href="http://to.azk.io/Run-Project_for-GitHub_EN">check here</a> for instructions on how to create a <strong><em>“Run Project” </em>button </strong>for your own repository on GitHub. At the moment, we only support public repositories.</p><h3>Other benefits</h3><p>We’ve learned so far that <em>Azkfile.js</em> is a requirement for using <strong><em>“Run Project”</em></strong> on GitHub.</p><p>Plus, even when a project isn’t on GitHub it still needs and <em>Azkfile.js </em>so it can run on <strong>azk </strong>through its CLI.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5WUQ5SsU6mQd2y7Seulh1Q.jpeg" /><figcaption><em>“Run Project” </em>(or alternatively: <em>$ azk start)</em></figcaption></figure><p>What else does A<em>zkfile.js </em>offer you as the owner of a repository on GitHub or a project’s user?</p><ol><li>Documentation;</li><li>Bug reporting and error simulation;</li><li>Evolution;</li><li>Deployment.</li></ol><h4>Documentation</h4><p>Besides being the application’s “owner’s manual” for <strong>azk</strong>, <em>Azkfile.js </em>is user documentation as well.</p><p>Just think about it for a moment. ;)</p><p><em>Azkfile.js </em>offers a high level view of a project’s architecture.</p><p>A quick read is enough for us to learn about its components: languages or frameworks, auxiliary applications (<em>e.g., workers</em>), databases, cache services etc. (and the relationships between them).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/770/1*zM1jI5NubNGzRnZYuGCbqg.png" /><figcaption>Azkfile.js &amp; architecture</figcaption></figure><h4>Bug reporting and error simulation</h4><p>Whenever a bug is reported in your code, you must be able to easily replicate it in order to devise a way to correct it.</p><p>However, it is quite possible that the issue is a result of a specific environment configuration on the user’s machine. A different version of a framework, a missed library that wasn’t installed, an extra (<em>or missing</em>) environment variable and… <em>poof!</em></p><p>You got a <em>non-existent </em>bug reported.</p><p>Even worse: that nasty bug is real, but the elements involved are actually elusive to zero in and replicate or they do depend on certain environment settings that more users may have on their machines.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/773/1*J54soT9WIPiNOndSSrkl4Q.png" /><figcaption>“It works on my machine!” :(</figcaption></figure><p>Navigating all that is far from trivial.</p><p>Too much time may end up being wasted in that effort. That’s time that could otherwise have been better spent building awesome new features.</p><p>Since A<em>zkfile.js </em>describes a project’s full architecture and each of its components runs as a service within a completely isolated context (<a href="https://www.docker.com/whatisdocker"><em>containers</em></a>), the environment’s configurations don’t affect a project’s execution.</p><p>Every user that runs your application with <strong>azk </strong>using the same <em>Azkfile.js</em> will be running the exact same configuration.</p><p>Thus, whenever you get a bug reported, it’ll be much easier to replicate that error and issue a correction.</p><h4>Evolution</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LHS9Ylpwqtq4ViMxb1T3Yw.jpeg" /></figure><p><em>Azkfile.js</em> brings forth a new language for quick application architecture visualization.</p><p>It’s like x-ray vision.</p><p>In no time you’ll realize it makes it easier to get <em>insights </em>about the best way to evolve an application (e.g., finding overloaded components) and design tests for possible solutions.</p><p>Here’s another frequent scenario where that makes a difference: when splitting an originally monolithic application or adding a new component (such as a queueing system for asynchronous processing or a new search engine) it gets easier to see all the architectural implications of these changes.</p><p>There are many small benefits like those that, in aggregate, end up being very valuable.</p><p>The confidence level you put in each decision is much higher.</p><p>Finally, <em>when it comes to actually applying changes to code</em>, <strong>azk </strong>streamlines the iterations in spades <a href="http://to.azk.io/Selfstarter_EN">as we have previously seen</a>.</p><h4>Deployment</h4><p>Deploying your application with <strong>azk </strong>is super easy! <a href="http://to.azk.io/deploy-howto_0001_EN">Check out this tutorial</a> for details.</p><p>All you’ll have to do is make <a href="http://to.azk.io/DOCs_Deploy_0001_EN">a simple addition</a> to your <em>Azkfile.js </em>and you’re all set.</p><h3>Conclusion</h3><p>The interesting thing about the additional benefits of creating an <em>Azkfile.js </em>for an application is the very original benefit of having an <em>Azkfile.js</em> (being able to use <strong>“Run Project”</strong> and <strong>azk).</strong></p><p><em>Azkfile.js is “live” documentation</em></p><p>Every single implementation or change in it results in what can only be described as “executable” documentation (with agility, automation and quality).</p><p>One thing pushes another.</p><p>Software development gets much streamlined and fluid. Productivity and satisfaction ensues.</p><p><em>You’ll spend less time busy with anything that’s not code.</em></p><p>Software is more and more embedded in everything we do. <a href="http://to.azk.io/Why_Software_Is_Eating_The_World">As someone adequately put</a>:</p><p><em>Software is eating the world</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*krJVcyofSaL13KXPZwRdhA.jpeg" /><figcaption>Azkfile.js is life ;)</figcaption></figure><p>So, let’s just code!</p><p>That’s all for today, folks. See ya! ;)<br><em>Azuki Team</em></p><h3>More about azk</h3><p>+ Site: <a href="http://azk.io/">http://azk.io</a><br>+ Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Documentation: <a href="http://docs.azk.io/">http://docs.azk.io</a><br>+ Images directory created by the <strong>azk </strong>team: <a href="http://images.azk.io/">http://images.azk.io</a></p><h3>Contribute to azk</h3><p>+ <em>Star</em> <strong>azk </strong>on<strong> </strong>Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Report an issue: <a href="https://github.com/azukiapp/azk/issues/new">https://github.com/azukiapp/azk/issues/new</a><br>+ Help solving a reported issue: <a href="https://github.com/azukiapp/azk/issues">https://github.com/azukiapp/azk/issues</a><br>+ Check out our awesome sponsors: <a href="http://azk.io/#sponsors">http://azk.io/#sponsors</a></p><h3>Stay in touch with the azk team</h3><p>+ Sign up the weekly digest: <a href="http://www.azk.io/#newsletter">http://www.azk.io/#newsletter</a><br>+ Follow the blog: <a href="https://medium.com/azuki-news">https://medium.com/azuki-news</a><br>+ Talk to our support (chat): <a href="https://gitter.im/azukiapp/azk">https://gitter.im/azukiapp/azk</a> (English) and <a href="https://gitter.im/azukiapp/azk/pt">https://gitter.im/azukiapp/azk/pt</a> (Português)<br>+ Facebook: <a href="https://www.facebook.com/azukiapp">https://www.facebook.com/azukiapp</a><br>+ Twitter: <a href="http://twitter.com/azukiapp">http://twitter.com/azukiapp</a><br>+ YouTube: <a href="https://www.youtube.com/user/Azukiapp/videos">https://www.youtube.com/user/Azukiapp/videos</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a554ae6abfbf" width="1" height="1" alt=""><hr><p><a href="https://medium.com/azuki-news/azkfile-js-your-user-deserves-it-and-so-do-you-a554ae6abfbf">Azkfile.js: your user deserves it (and so do you!)</a> was originally published in <a href="https://medium.com/azuki-news">Azuki News</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Azkfile.js: seu usuário merece (e você também!)]]></title>
            <link>https://medium.com/@felipe.arenales/azkfile-js-seu-usu%C3%A1rio-merece-e-voc%C3%AA-tamb%C3%A9m-24b4cfb7b466?source=rss-96484bab8367------2</link>
            <guid isPermaLink="false">https://medium.com/p/24b4cfb7b466</guid>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[github]]></category>
            <category><![CDATA[azk]]></category>
            <dc:creator><![CDATA[Felipe Arenales Santos]]></dc:creator>
            <pubDate>Fri, 25 Sep 2015 10:02:28 GMT</pubDate>
            <atom:updated>2015-09-25T16:25:51.485Z</atom:updated>
            <content:encoded><![CDATA[<h3>Azkfile.js: seus usuários merecem (e você também!)</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/700/1*59Reab1ccqjYvFAmu186LA.jpeg" /><figcaption>toda obra de engenharia começa como um projeto</figcaption></figure><p>To read the English version, <a href="http://to.azk.io/Azkfile-js_Why_0001_EN_x">click here</a>.</p><p><a href="http://to.azk.io/run-release_pt-BR">Na semana passada, lançamos</a> o &quot;<strong><em>Run Project&quot;</em> button</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/183/1*wdGvZ6DzzBVInd2au04Zbw.png" /></figure><p>Como dissemos naquela ocasião:</p><p><em>O “</em><strong><em>Run Project” </em></strong><em>é o botão de “play” para o GitHub</em></p><p>Clique no botão e o código que você acabou de ver no repositório no <a href="https://github.com/">GitHub </a>estará rodando (<em>com segurança!)</em> na sua máquina local em poucos minutos.</p><p><a href="http://to.azk.io/run-howto_0001_pt-BR">Confira o tutorial</a> para uma demonstração detalhada.</p><p>Para isso, é necessária instalação do <strong>azk</strong>. <a href="http://to.azk.io/welcome_pt-Br">Como explicamos antes</a>:</p><p><em>O </em><strong><em>azk</em></strong><em> é um orquestrador de ambientes de desenvolvimento</em></p><p>O <strong>azk </strong>também pode ser usado diretamente, inclusive em projetos que ainda não contem com o <strong><em>&quot;Run Project&quot; </em></strong>(ou que nem estejam no GitHub).</p><p>Ele foi feito para o <em>desenvolvedor individual </em>e para <em>pequenos times</em>.</p><p>Tanto faz se estamos falando de um <a href="http://to.azk.io/Rails-install_pt-BR">projeto novo iniciado do zero</a> ou de uma <a href="http://to.azk.io/Selfstarter_pt-BR">aplicação pré-existente</a>, o <strong>azk </strong>automaticamente instala e configura o ambiente de desenvolvimento pra você.</p><p>O <strong>azk </strong>é operado através de uma CLI (<em>command line interface</em>) e do <em>Azkfile.js</em>.</p><p>Mas o que é mesmo um <em>Azkfile.js</em>?</p><h3>Manual do usuário</h3><p><em>O </em><strong><em>Azkfile.js</em></strong><em> é o &quot;manual do usuário&quot; da sua aplicação para o </em><strong><em>azk</em></strong></p><p>Ele é um arquivo de manifesto simples que lista os componentes da arquitetura de uma aplicação e descreve de forma bastante sucinta (<em>mesmo!</em>) as relações entre eles.</p><p>Sua função é informar a arquitetura ao <strong>azk</strong> para que ele possa <em>prover o ambiente</em> e <em>executar os sistemas </em>envolvidos.</p><p>Como sugere a sua extensão, o <em>Azkfile.js</em> é baseado em JavaScript, que possui uma sintaxe popular, simples e de fácil assimilação. De qualquer forma, nenhum conhecimento da linguagem é necessário para usar um <em>Azkfile.js </em>com o <strong>azk</strong>.</p><p>Veja abaixo um exemplo de <em>Azkfile.js </em>para <a href="http://to.azk.io/run-project_gallery_Stringer">uma aplicação real</a>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b76f621ff90ea6a9b37f24fbb22b0607/href">https://medium.com/media/b76f621ff90ea6a9b37f24fbb22b0607/href</a></iframe><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lNrddbSwroPc8aAgdTYfzw.png" /><figcaption><em>Azkfile.js</em> em ação no <strong>azk: </strong>“Que bruxaria foi essa?”</figcaption></figure><h3>Como criar</h3><p>A documentação do <strong>azk </strong>possui uma <a href="http://to.azk.io/Azkfile-js_pt-Br">seção sobre o <em>Azkfile.js</em></a> que oferece uma explicação completa e sucinta de como produzir um para sua aplicação.</p><p>A <a href="http://to.azk.io/Azkfile-js_reference_pt-BR">seção de referência</a> lista todos os parâmetros suportados pelo <em>Azkfile.js</em> e a forma correta de utilizá-los.</p><p>Você pode compor o <em>Azkfile.js </em>inteiro por conta própria a partir do zero, mas pode também usar o comando <em>`azk init`</em>do <strong>azk</strong>.</p><p>Ele já consegue criar automaticamente a maior parte do arquivo pra você. Daí, você pode fazer os eventuais ajustes e adições que julgar necessários. Saiba mais sobre o <em>`azk init` </em><a href="http://to.azk.io/azk-init_0001_BR">nesta seção da documentação</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*brokhL5LIcCPMnBO-1FWDA.png" /><figcaption>$ azk init</figcaption></figure><p>Por fim, <a href="http://to.azk.io/Run-Project_for-GitHub_pt-BR">veja aqui</a> como criar um botão <strong><em>“Run Project” </em></strong>para o seu repositório no GitHub. No momento, apenas repositórios públicos são suportados.</p><p>Curiosidade para usuários avançados: <a href="http://to.azk.io/DSLs_Javascript_pt-BR">veja nestes slides</a> o processo de decisão de guiou a criação da DSL do <em>Azkfile.js.</em></p><h3>Outros benefícios</h3><p>Já vimos que o <em>Azkfile.js </em>é um requisito para o funcionamento do<br><strong><em>&quot;Run Project&quot;</em></strong> em um projeto no GitHub.</p><p>Além disso, mesmo que um projeto não esteja no GitHub, ele precisa de um <em>Azkfile.js</em> para que ele possa ser executado diretamente através da CLI do <strong>azk</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5WUQ5SsU6mQd2y7Seulh1Q.jpeg" /><figcaption><em>“Run Project” </em>(ou ainda: <em>$ azk start)</em></figcaption></figure><p>O que mais o <em>Azkfile.js </em>oferece para você como autor de um projeto no GitHub ou como usuário de um projeto?</p><ol><li>Documentação;</li><li>Relato de bugs e simulação de erros;</li><li>Evolução;</li><li>Deploy.</li></ol><h4>Documentação</h4><p>Além de servir de &quot;manual do usuário&quot; da aplicação para o <strong>azk</strong>, o <em>Azkfile.js</em><br>já é documentação (para o desenvolvedor).</p><p>Pense nisso por um instante. ;)</p><p>O <em>Azkfile.js</em> oferece uma visão de alto nível da arquitetura do projeto.</p><p>Uma rápida leitura dele é o bastante para sabermos elementos empregados como linguagem e/ou framework utilizados, aplicações auxiliares (<em>workers</em>, por exemplo), bancos de dados, serviços de cache etc. (e as relações entre eles).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/770/1*zM1jI5NubNGzRnZYuGCbqg.png" /><figcaption>Azkfile.js &amp; arquitetura</figcaption></figure><h4>Relato de bugs e simulação de erros</h4><p>Quando alguém reporta um bug em seu projeto, você deve ser capaz de reproduzi-lo facilmente para entender como corrigi-lo.</p><p>Contudo, é possível que aquela situação reportada seja fruto da configuração específica do ambiente do usuário. Uma versão diferente do framework, uma biblioteca não instalada, uma variável de ambiente a mais (<em>ou a menos</em>) e… <em>puft</em>!</p><p>Um bug inexistente foi reportado.</p><p>Ou pior ainda: o bug é real, mas os elementos envolvidos na sua simulação são de difícil replicação ou realmente dependem de elementos de ambiente em que mais usuários podem incorrer.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/773/1*J54soT9WIPiNOndSSrkl4Q.png" /><figcaption>“Não funciona na minha máquina!” :(</figcaption></figure><p>Navegar por tudo isso não é trivial.</p><p>Muito tempo pode ser consumido nesse esforço. Isso é tempo que poderia ser usado com desenvolvimento de novas funcionalidades.</p><p>Como o <em>Azkfile.js</em> especifica a arquitetura completa do projeto e cada componente dele é executado como um serviço num contexto isolado (<a href="https://www.docker.com/whatisdocker"><em>containers</em></a>), as configurações do ambiente não afetam a execução do projeto.</p><p>Todos os usuários que rodarem seu projeto usando o <strong>azk</strong> com o mesmo <em>Azkfile.js</em> estarão rodando a mesma configuração.</p><p>Dessa forma, sempre que um bug for reportado, será muito mais fácil reproduzir o erro e fazer a correção.</p><h4>Evolução</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LHS9Ylpwqtq4ViMxb1T3Yw.jpeg" /></figure><p>Com o <em>Azkfile.js,</em> temos mais uma linguagem para facilmente visualizarmos a arquitetura da aplicação.</p><p>É uma espécie de visão de raio-x.</p><p>Em pouco tempo, você notará que ficou mais fácil ter <em>insights </em>sobre como melhor evoluir uma aplicação (por exemplo, encontrar componentes sobrecarregados) e definir testes para soluções possíveis.</p><p>Outro exemplo de situação corriqueira, mas não trivial, em que isso faz diferença: ao dividir uma aplicação originalmente monolítica ou ao adicionar um novo componente (como um sistema de filas para processamento assíncrono ou novo motor de buscas), fica mais fácil enxergar todas as implicações arquiteturais das novas mudanças.</p><p>Enfim, são vários os pequenos benefícios nesse sentido que, em agregado, fazem muita diferença na prática.</p><p>O nível de confiança nas decisões fica bem maior.</p><p>Por fim, <em>na hora de implementar as mudanças</em>, o <strong>azk </strong>agiliza MUITO o processo de iteração de uma aplicação pré-existente, <a href="http://to.azk.io/Selfstarter_pt-BR">como já vimos antes</a>.</p><h4>Deploy</h4><p>Fazer o deploy da sua aplicação com o <strong>azk </strong>é MUITO simples! <a href="http://to.azk.io/deploy-howto_0001_pt-BR">Veja o tutorial</a> para maiores detalhes.</p><p>Para que isso funcione, basta fazer <a href="http://to.azk.io/DOCs_Deploy_0001_pt-BR">uma adição trivial</a> ao seu A<em>zkfile.js </em>e pronto!</p><h3>Conclusão</h3><p>O mais interessante das vantagens adicionais da criação de um <em>Azkfile.js </em>para uma aplicação é justamente a vantagem original de se ter um <em>Azkfile.js </em>(uso do <strong>&quot;Run Project&quot;</strong> e do <strong>azk</strong>).</p><p><em>O Azkfile.js é documentação &quot;viva&quot;</em></p><p>Toda e qualquer implementação ou alteração nesse sentido resulta em uma documentação &quot;executável&quot; (com alto grau de agilidade, automação e qualidade).</p><p>Uma coisa reforça a outra.</p><p>O trabalho de desenvolvimento fica muito mais integrado e fluido. Fica tudo mais produtivo e prazeroso.</p><p><em>Você passa menos tempo ocupado com coisas que não são código.</em></p><p>Software está cada vez mais presente em tudo o que fazemos. <a href="http://to.azk.io/Why_Software_Is_Eating_The_World">Como alguém já disse</a>:</p><p><em>Software is eating the world</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*krJVcyofSaL13KXPZwRdhA.jpeg" /><figcaption>Azkfile.js é vida ;)</figcaption></figure><p>Então, vamos codar mais!</p><p>Por hoje é só, pessoal. Valeu!<em><br>Time Azuki</em></p><h3>Mais sobre o azk</h3><p>+ Site: <a href="http://azk.io/">http://azk.io</a><br>+ Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Documentação: <a href="http://docs.azk.io/">http://docs.azk.io</a><br>+ Diretório de imagens criadas pelo time do <strong>azk</strong>: <a href="http://images.azk.io/">http://images.azk.io</a></p><h3>Contribua com o azk</h3><p>+ “<em>Star”</em> o <strong>azk </strong>no Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Reporte um problema: <a href="https://github.com/azukiapp/azk/issues/new">https://github.com/azukiapp/azk/issues/new</a><br>+ Ajude a resolver um problema reportado: <a href="https://github.com/azukiapp/azk/issues">https://github.com/azukiapp/azk/issues</a><br>+ Confira os sponsors do <strong>azk</strong>: <a href="http://azk.io/#sponsors">http://azk.io/#sponsors</a></p><h3>Fale com o time do azk</h3><p>+ Assine a newsletter semanal: <a href="http://www.azk.io/#newsletter">http://www.azk.io/#newsletter</a><br>+ Acompanhe o blog: <a href="https://medium.com/azuki-news">https://medium.com/azuki-news</a><br>+ Fale com nosso suporte (chat): <a href="https://gitter.im/azukiapp/azk/pt">https://gitter.im/azukiapp/azk/pt</a> (Português) e <a href="https://gitter.im/azukiapp/azk">https://gitter.im/azukiapp/azk</a> (English)<br>+ Facebook: <a href="https://www.facebook.com/azukiapp">https://www.facebook.com/azukiapp</a><br>+ Twitter: <a href="http://twitter.com/azukiapp">http://twitter.com/azukiapp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=24b4cfb7b466" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Hi, I'm azk v0.15.0]]></title>
            <link>https://medium.com/azuki-news/hi-i-m-azk-v0-15-0-9486c9c1a34f?source=rss-96484bab8367------2</link>
            <guid isPermaLink="false">https://medium.com/p/9486c9c1a34f</guid>
            <category><![CDATA[docker]]></category>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[azk]]></category>
            <dc:creator><![CDATA[Felipe Arenales Santos]]></dc:creator>
            <pubDate>Thu, 17 Sep 2015 23:17:23 GMT</pubDate>
            <atom:updated>2015-10-28T03:53:12.787Z</atom:updated>
            <content:encoded><![CDATA[<h3>Hi, I’m azk v0.15.0</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KsbNkvDT7W8eRwADVpUEKQ.jpeg" /><figcaption>&quot;Woof!&quot;</figcaption></figure><p>Para ler a versão em Português, <a href="http://to.azk.io/v0-15-0_pt-BR">clique aqui</a>.</p><p>Hello!</p><p>We’re pleased to announce today a brand new version of <strong>azk</strong>!</p><h3>Azuki CI on Twitter</h3><p>azk v0.15.0 released : changelog http://bit.ly/azk_v0-15-0 : upgrade instructions http://bit.ly/azk_upgrade_howto ...</p><p>This time, our main goals were in <em>compatibility</em> and <em>new functionality</em>.</p><p>Besides many other resources “under the hood”, <strong>azk</strong> uses <a href="https://www.docker.com/">Docker</a> as its <em>containerization </em>layer. In its latest releases, Docker has altered some of its fundamental behaviors (including its own API) on which <strong>azk</strong> is based.</p><p>So, we updated <strong>azk </strong>to make it fully compatible with those latest Docker incarnations. Actually, they are now <strong>azk </strong>requirements.</p><p>If you are a Linux user, you’ll need to have Docker <em>1.8.1</em> installed (or higher). If you use Mac OS X, don’t worry: we have already updated our VirtualBox image (which is included in <strong>azk </strong>itself) with Docker’s latest versions. :)</p><p>The <em>`azk start` </em>command<em> </em>has also gone through some significant makeover. It is now possible to pass a <a href="https://github.com/">GitHub</a> URL as an argument. Thus, <strong>azk </strong>can download the corresponding repository to your current directory and run <em>`azk start`</em> regularly in order to, well, start the systems described on the project’s <a href="http://to.azk.io/Azkfile-js_en">Azkfile.js</a>.</p><pre>$ azk start -o <a href="https://github.com/run-project/shout">https://github.com/run-project/shout</a></pre><p>Please, note that an <a href="http://to.azk.io/Azkfile-js_en">Azkfile.js</a> for the project must have been previously created and made available on the repo.</p><p>We created that feature to support the operation of the<br>“<strong><em>Run Project” </em>button.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/183/1*wdGvZ6DzzBVInd2au04Zbw.png" /></figure><p>Learn more about this new <strong>azk </strong>resource and how it completely transforms the experience of running code straight out of GitHub on your local machine on our release article<strong> </strong>here.</p><p>As always, lots of minor improvements and corrections here and there on <strong>azk </strong><em>v0.15.0. </em>Don’t miss our <a href="http://to.azk.io/v0-15-0_Changelog"><em>changelog</em> here</a>.</p><h4>Get azk</h4><p>Follow the <a href="http://to.azk.io/install_EN">instructions here</a> to get <strong>azk </strong>via one of the supported packet managers.</p><p>You can also <a href="http://to.azk.io/v0-15-0_zip">get the zip file</a> with the latest version and follow the <a href="http://to.azk.io/install_source-code_EN">installation directions</a>.</p><p>Just click to code! ;)<br><em>Azuki Team</em></p><h3>More about azk</h3><p>+ Site: <a href="http://azk.io/">http://azk.io</a><br>+ Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Documentation: <a href="http://docs.azk.io/">http://docs.azk.io</a><br>+ Images directory created by the <strong>azk </strong>team: <a href="http://images.azk.io/">http://images.azk.io</a></p><h3>Contribute to azk</h3><p>+ <em>Star</em> <strong>azk </strong>on<strong> </strong>Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Report an issue: <a href="https://github.com/azukiapp/azk/issues/new">https://github.com/azukiapp/azk/issues/new</a><br>+ Help solving a reported issue: <a href="https://github.com/azukiapp/azk/issues">https://github.com/azukiapp/azk/issues</a><br>+ Check out our awesome sponsors: <a href="http://azk.io/#sponsors">http://azk.io/#sponsors</a></p><h3>Stay in touch with the azk team</h3><p>+ Sign up the weekly digest: <a href="http://www.azk.io/#newsletter">http://www.azk.io/#newsletter</a><br>+ Follow the blog: <a href="https://medium.com/azuki-news">https://medium.com/azuki-news</a><br>+ Talk to our support (chat): <a href="https://gitter.im/azukiapp/azk">https://gitter.im/azukiapp/azk</a> (English) and <a href="https://gitter.im/azukiapp/azk/pt">https://gitter.im/azukiapp/azk/pt</a> (Português)<br>+ Facebook: <a href="https://www.facebook.com/azukiapp">https://www.facebook.com/azukiapp</a><br>+ Twitter: <a href="http://twitter.com/azukiapp">http://twitter.com/azukiapp</a><br>+ YouTube: <a href="https://www.youtube.com/user/Azukiapp/videos">https://www.youtube.com/user/Azukiapp/videos</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9486c9c1a34f" width="1" height="1" alt=""><hr><p><a href="https://medium.com/azuki-news/hi-i-m-azk-v0-15-0-9486c9c1a34f">Hi, I&#39;m azk v0.15.0</a> was originally published in <a href="https://medium.com/azuki-news">Azuki News</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[[HowTo] "Run Project": E o deploy?]]></title>
            <link>https://medium.com/@felipe.arenales/howto-run-project-e-o-deploy-1cf46c80dbd0?source=rss-96484bab8367------2</link>
            <guid isPermaLink="false">https://medium.com/p/1cf46c80dbd0</guid>
            <category><![CDATA[digitalocean]]></category>
            <category><![CDATA[azk]]></category>
            <category><![CDATA[open-source]]></category>
            <dc:creator><![CDATA[Felipe Arenales Santos]]></dc:creator>
            <pubDate>Thu, 17 Sep 2015 12:57:19 GMT</pubDate>
            <atom:updated>2015-09-18T22:10:07.243Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*DeeUcB9nAW2rASS-tPOJ8g.jpeg" /><figcaption><em>$ azk shell deploy</em></figcaption></figure><p>To read the English version, <a href="http://to.azk.io/deploy-howto_0001_EN">click here</a>.</p><p>Tudo bem, pessoal?</p><p>Como já mencionamos em outros artigos, <a href="http://to.azk.io/run-release_pt-BR">estamos lançando hoje</a> o “<strong><em>Run Project”</em> button</strong>.</p><p>Trata-se de uma nova funcionalidade do <strong>azk</strong>.</p><p>Vamos mostrar aqui como é simples subir uma aplicação a partir da<br><a href="http://to.azk.io/run-gallery">galeria do <em>“</em><strong><em>Run Project”</em> button</strong></a><strong> </strong>para a <a href="https://www.digitalocean.com/">DigitalOcean</a>, passando pela sua máquina local (caso você queira usar ou modificar o código primeiro).</p><p><strong>tl;dr</strong></p><ol><li>Acesse a <a href="http://to.azk.io/run-gallery">galeria de projetos</a> do “<strong><em>Run Project” </em>button</strong> e <a href="http://to.azk.io/run-howto_0001_pt-BR">execute o projeto de sua escolha</a>;</li><li>Configure as chaves SSH em sua máquina seguindo os passos 1 e 2 <a href="https://help.github.com/articles/generating-ssh-keys/">deste tutorial</a>;</li><li>Obtenha sua chave de acesso da DigitalOcean <a href="https://cloud.digitalocean.com/settings/applications">aqui</a>;</li><li>Execute:</li></ol><pre>$ cd pasta/do/projeto<br>$ echo “DEPLOY_API_TOKEN=&lt;SUA-CHAVE-DE-ACESSO&gt;” &gt;&gt; .env<br>$ azk shell deploy</pre><p>—</p><p>Mostramos em nosso <a href="http://to.azk.io/run-howto_0001_pt-BR">tutorial anterior</a> como usar o “<strong><em>Run Project” </em>button </strong>para executar localmente um projeto direto de <a href="http://to.azk.io/run-gallery">nossa galeria</a> no GitHub de maneira incrivelmente <em>rápida</em> e <em>simples</em> (além de <em>segura</em>)!</p><p>Antes disso, tínhamos demonstrado em <a href="http://to.azk.io/DigitalOcean_0001_pt-BR">outro tutorial</a> como deployar uma aplicação direto do <strong>azk</strong> para a DigitalOcean.</p><p>Então…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/548/1*bj62jlUiPBREawes-8Civw.jpeg" /><figcaption>“Por que não os dois?” -Dr. Zoidberg</figcaption></figure><p>Vamos combinar esses dois recursos do <strong>azk </strong>para demonstrar como o código de um repo pode ir facilmente <em>do GitHub </em>à<em> DigitalOcean</em>, passando pela sua máquina local (para que você, <em>que é programador</em>, tenha oportunidade de trabalhar nele primeiro se assim desejar).</p><p>Pensando nisso, já adicionamos o sistema de deploy a todos os <a href="http://to.azk.io/run-gallery">projetos da galeria</a>! Para subir qualquer um deles para a DigitalOcean, basta seguir os passos a seguir.</p><p><strong><em>Atenção</em></strong><em>: você precisará da versão mais recente do </em><strong><em>azk </em></strong><em>para esta demonstração (vide abaixo).</em></p><h3>Azuki CI on Twitter</h3><p>azk v0.15.0 released : changelog http://bit.ly/azk_v0-15-0 : upgrade instructions http://bit.ly/azk_upgrade_howto ...</p><ol><li><strong>Rodando a aplicação localmente;</strong></li></ol><p>Primeiro, é preciso rodar a aplicação localmente. Já <a href="http://to.azk.io/run-howto_0001_pt-BR">vimos antes</a> que isso é MUITO<em> </em>simples com o “<strong><em>Run Project”</em>.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/889/1*Y9zs92WuucKtUihuldDWtQ.png" /><figcaption>exemplo de projeto na galeria do <strong><em>“Run Project”</em></strong></figcaption></figure><p><strong>2. Configurando as chaves SSH;</strong></p><p>Em seguida, é necessário configurar as chaves SSH em sua máquina. Elas serão úteis para fazermos a conexão com a máquina da DigitalOcean e para enviarmos os arquivos do projeto. Se você ainda não tem chaves SSH criadas em sua máquina (ou não tem certeza sobre isso), siga os passos 1 e 2<br><a href="https://help.github.com/articles/generating-ssh-keys/">deste tutorial</a>.</p><p><strong>3. Adicionando suas credenciais;</strong></p><p>Obtenha suas credenciais de acesso (<em>Personal Access Token</em>) da DigitalOcean <a href="https://cloud.digitalocean.com/settings/applications">aqui</a> e coloque-as no arquivo <em>.env:</em></p><pre>$ cd pasta/do/projeto<br>$ echo “DEPLOY_API_TOKEN=&lt;SUA-CHAVE-DE-ACESSO&gt;” &gt;&gt; .env</pre><p><strong>4. Fazendo o deploy;</strong></p><p>Daí, basta executar o comando de deploy.</p><pre>$ azk shell deploy</pre><p>Vale lembrar que esse processo pode levar alguns minutos (ele vai configurar a máquina, subir seu código e executá-lo). Automatizamos muita coisa pra você. ;)</p><p>Além disso, a senha de liberação da sua chave SSH pode ser requerida durante esse processo.</p><p>Por fim, você verá uma mensagem informando que o deploy foi realizado e que sua aplicação já pode ser acessada pelo IP da máquina da DigitalOcean (como no exemplo abaixo):</p><pre>App successfully deployed at <a href="http://45.55.77.12/">http://45.55.77.12</a></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*l6ybuS5m_PACEzZB1MIwVA.png" /><figcaption>pronto!</figcaption></figure><p>Para saber mais sobre o deployment usando o <strong>azk</strong> e outras opções disponíveis, <a href="http://to.azk.io/doc_deploy_DigitalOcean_pt-BR">cheque a documentação</a>.</p><p>—</p><h4><strong>Bônus: acessando sua aplicação via um domínio customizado</strong></h4><p>Após subir sua aplicação para a DigitalOcean, você pode fazer duas simples configurações para acessá-la via um domínio customizado (por exemplo, <em>meudominio.com.br</em>).</p><p>Para isso, você deve já possuir o domínio utilizado e ter acesso às suas configurações de DNS.</p><p><strong>Configurando o azk para aceitar requisições de um domínio customizado;</strong></p><p>Edite seu <a href="http://to.azk.io/Azkfile-js_pt-Br"><em>Azkfile.js</em></a> e procure pelo sistema <em>deploy. </em>Altere as <em>envs, </em>adicionando seu domínio à variável <em>`HOST_DOMAIN</em>`:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e58de41a06c3255aeeb30552aa4d04d6/href">https://medium.com/media/e58de41a06c3255aeeb30552aa4d04d6/href</a></iframe><p>Salve, faça o <em>commit</em> no git e execute novamente:</p><pre>$ git add Azkfile.js<br>$ git commit -m &quot;Adding a custom domain into Azkfile.js&quot;<br>$ azk shell deploy</pre><p><strong>Adicionando o IP da DigitalOcean aos registros do seu servidor de DNS;</strong></p><p>Em seguida, você deve acessar o seu serviço de DNS e adicionar a seguinte entrada:</p><ul><li><strong>Tipo:</strong> <em>A Record</em> (ou simplesmente <em>A</em>);</li><li><strong>Nome:</strong> Nome do subdomínio (<em>www, </em>por exemplo). Deixe em branco se quiser utilizar o próprio domínio (<em>meudominio.com.br</em>) como endereço;</li><li><strong>Endereço:</strong> IP da máquina da DigitalOcean (<em>45.55.77.12</em>, no exemplo acima);</li><li><strong>TTL: </strong>600 (ou 10 minutos);</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YN-zyPJ_q5dOoiv5G1ZakA.png" /><figcaption>Adicionando o registro de DNS para o domínio meudominio.com.br</figcaption></figure><p>Após configurar a entrada em seu serviço de DNS e de configurar o <strong>azk</strong> para suportar o novo endereço, já é possível acessar a aplicação utilizando o domínio customizado.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xcPygoIL1Wd0r18MtgIhmg.png" /><figcaption>agora sim!</figcaption></figure><p>Vale lembrar que a propagação de DNS na rede pode levar alguns minutos.</p><p>Pronto! Executamos localmente código que pouco antes estava no GitHub e, em seguida, fizemos o seu deploy para a DigitalOcean.</p><p>E foi muito rápido e fácil!</p><p>Lembre-se de que o <strong>azk </strong>não é só para o <strong><em>“Run Project”</em> button</strong>!</p><p>Você também pode usá-lo para rodar qualquer aplicação (<a href="http://to.azk.io/Rails-install_pt-BR">nova</a> ou <a href="http://to.azk.io/Selfstarter_pt-BR">pré-existente</a>) em sua máquina local e, daí em diante, f<a href="http://to.azk.io/DigitalOcean_0001_pt-BR">azer o seu deploy na DigitalOcean</a> (mesmo sem <strong><em>“Run Project”</em> button</strong>).</p><p>Caso você queira sugerir projetos para a galeria do <strong><em>“Run Project”</em></strong>, fique à vontade para abrir uma issue ou enviar um <em>pull request </em>com seu projeto (<a href="http://to.azk.io/run-gallery">na própria galeria</a> em ambos os casos).</p><p>O único requisito para o uso do <strong><em>“Run Project”</em> </strong>em um projeto é a criação prévia de do seu <a href="http://to.azk.io/Azkfile-js_pt-Br">Azkfile.js</a>. Daí, supondo que a URL do seu projeto no GitHub fosse <em>https://github.com/username/repo </em>e que o Azkfile.js estivesse no branch <em>azkfile</em>, o código Markdown do <strong>azk button</strong> seria:</p><pre>[![Run project](https://s3-sa-east-1.amazonaws.com/assets.azk.io/run-project.png)](http://run.azk.io/start/?repo=username/repo&amp;ref=azkfile)</pre><p>É isso. :)</p><p>Deployemos!<br><em>Time Azuki</em></p><h3>Mais sobre o azk</h3><p>+ Site: <a href="http://azk.io/">http://azk.io</a><br>+ Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Documentação: <a href="http://docs.azk.io/">http://docs.azk.io</a><br>+ Diretório de imagens criadas pelo time do <strong>azk</strong>: <a href="http://images.azk.io/">http://images.azk.io</a></p><h3>Contribua com o azk</h3><p>+ <em>“Star”</em> o <strong>azk </strong>no Github: <a href="https://github.com/azukiapp/azk">https://github.com/azukiapp/azk</a><br>+ Reporte um problema: <a href="https://github.com/azukiapp/azk/issues/new">https://github.com/azukiapp/azk/issues/new</a><br>+ Ajude a resolver um problema reportado: <a href="https://github.com/azukiapp/azk/issues">https://github.com/azukiapp/azk/issues</a><br>+ Confira os sponsors do <strong>azk</strong>: <a href="http://azk.io/#sponsors">http://azk.io/#sponsors</a></p><h3>Fale com o time do azk</h3><p>+ Assine a newsletter semanal: <a href="http://www.azk.io/#newsletter">http://www.azk.io/#newsletter</a><br>+ Acompanhe o blog: <a href="https://medium.com/azuki-news">https://medium.com/azuki-news</a><br>+ Fale com nosso suporte (chat): <a href="https://gitter.im/azukiapp/azk/pt">https://gitter.im/azukiapp/azk/pt</a> (Português) e <a href="https://gitter.im/azukiapp/azk">https://gitter.im/azukiapp/azk</a> (English)<br>+ Facebook: <a href="https://www.facebook.com/azukiapp">https://www.facebook.com/azukiapp</a><br>+ Twitter: <a href="http://twitter.com/azukiapp">http://twitter.com/azukiapp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1cf46c80dbd0" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>