Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dersonsena/yii2-deploy
Módulo de deploy automático no formato de Modules do Yii Framework 2
https://github.com/dersonsena/yii2-deploy
Last synced: about 1 month ago
JSON representation
Módulo de deploy automático no formato de Modules do Yii Framework 2
- Host: GitHub
- URL: https://github.com/dersonsena/yii2-deploy
- Owner: dersonsena
- Created: 2016-06-26T14:00:41.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-08-09T12:10:07.000Z (over 7 years ago)
- Last Synced: 2024-04-04T01:27:36.415Z (7 months ago)
- Language: PHP
- Size: 21.5 KB
- Stars: 5
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://packagist.org/packages/dersonsena/yii2-user-module)
[](https://packagist.org/packages/dersonsena/yii2-user-module)
[](https://packagist.org/packages/dersonsena/yii2-user-module)
[](https://packagist.org/packages/dersonsena/yii2-user-module)
Yii2 Deploy
===========================
Módulo de deploy automático no formato de Modules do Yii Framework 2. Caso você queira, que para todo comando ```git push``` no seu
ambiente de desenvolvimento local, automaticamente atualize o seu repositório remoto, basta seguir as instruções e passos abaixo.
[](http://www.yiiframework.com/)
PRÉ-REQUISITOS
-------------------
* GIT instalando no seu servidor;
* Função nativa do PHP `shell_exec` habilitada no seu servidor WEB;
INSTRUÇÕES PARA INSTALAÇÃO
-------------------
A maneira recomendada para instalar esta extensão é através do [composer](http://getcomposer.org/download/).
Execute no seu terminal
```
$ php composer.phar require dersonsena/yii2-deploy "*"
```
ou adicione
```
"dersonsena/yii2-deploy": "*"
```
na seção ```require``` do seu arquivo `composer.json`.
PASSO 1 - REGISTRANDO MÓDULO
-------------------
Registre o módulo no arquivo de configuração ```config/web.php``` conforme o trecho abaixo:
```php
'modules' => [
...
'deploy' => [
'class' => 'dersonsena\deploy\DeployModule',
'token' => '',
],
...
]
```
Você pode utilizar algumas soluções online para gerar seu token. Abaixo, alguns sites:
* [http://www.miraclesalad.com/webtools/md5.php](http://www.miraclesalad.com/webtools/md5.php)
* [http://www.md5.cz](http://www.md5.cz)
* [http://passwordsgenerator.net/md5-hash-generator/](http://passwordsgenerator.net/md5-hash-generator)
Você pode também gerar facilmente um token utilizando o componente
[yii\base\Security](http://www.yiiframework.com/doc-2.0/yii-base-security.html#generateRandomString()-detail) do Yii2 para gerar um token,
como abaixo:
```php
echo \Yii::$app->security->generateRandomString()
```
PASSO 2 - FAZENDO PRIMEIRO TESTE
-------------------
Para efeitos de teste, acesse esta URL no seu navegador:
```
http://seudominio.com.br/deploy?t=SEU_TOKEN
```
O módulo deverá "devolver" uma tela com os comandos executados.
PASSO 3 - INTEGRAÇÃO
-------------------
Caso tenha dado tudo certo no ```PASSO 2```, siga os passos abaixo para integrar sua aplicação
### 3.1 INTEGRAÇÃO COM BITBUCKET
1. Navegue até o endereço do seu repositório e vá na seção ```settings```;
2. Navegue até a seção ```Integrations >> Webhooks```;
3. Clique no botão ```Add Webhook```;
4. Informe um ```title``` de sua preferência;
5. No campo ```URL``` insira: http://seudominio.com.br/deploy?t=SEU_TOKEN
6. Clique no Botão ```Save```.
EXTRAS
-------------------
### GERAÇÃO DE LOGS
O Yii2-Deploy a cada execução de comandos no servidor de Produção gera um arquivo ```.txt``` com o log da saída do terminal
no diretório:
```
/runtime/deploy/20160626143800.txt
```
**IMPORTANTE:** só será feito a geração do LOG caso você não esteja no ambiente de Desenvolvimento ```YII_ENV_DEV```.
### ALTERANDO O BRANCH
Caso você queira que a instrução ```git pull``` utilize um outro branch, basta sobrescrever a propriedade ```branch``` no seu ```config/web.php```, como abaixo:
```php
'modules' => [
...
'deploy' => [
'class' => 'dersonsena\deploy\DeployModule',
'token' => '',
'branch' => 'meu-branch'
],
...
]
```
### FORÇAR EXECUÇÃO DOS COMANDOS NO AMBIENTE DE DESENVOLVIMENTO
Por padrão, o módulo Yii2-Deploy não executa os comandos gerados no ambiente de desenvolvimento. Mas, caso você queira desabilitá-lo,
basta sobrescrever a propriedade ```forceExecuteCommands``` no seu ```config/web.php```, como abaixo:
```php
'modules' => [
...
'deploy' => [
'class' => 'dersonsena\deploy\DeployModule',
'token' => '',
'forceExecuteCommands' => true
],
...
]
```
### PARAMETRIZAÇÕES
```php
'modules' => [
...
'deploy' => [
'class' => 'dersonsena\deploy\DeployModule',
'token' => '',
'enableComposer' => true // Padrão: true
'gitBin' => '/usr/bin/git', // Caminho para o comando git do servidor (Padrão: /usr/bin/git)
'phpBin' => '/usr/bin/php', // Caminho para o comando php do servidor (Padrão: /usr/bin/php)
'composerBin' => '/usr/bin/composer' // Caminho para o comando composer do servidor (Padrão: /usr/bin/composer),
'composerHome' => '/path/to/.composer' // Caminho para o COMPOSER_HOME (Padrão: null)
],
...
]
```