Rumah >rangka kerja php >Laravel >Mari kita bincangkan tentang cara menggunakan Tindakan GitHub untuk menggunakan projek Laravel secara automatik
Bagaimana untuk menggunakan projek Laravel secara automatik menggunakan Tindakan GitHub? Dalam artikel ini, saya akan membimbing anda bagaimana untuk menggunakan aplikasi Laravel anda secara automatik pada VPS secara percuma.
Saya adalah sebahagian daripada pasukan kecil yang bekerja pada projek Laravel yang digunakan pada VPS. Setiap ahli pasukan kami akan mengusahakan tugas tertentu, dan apabila tugas itu sedia untuk pengeluaran, seseorang akan sentiasa memerlukan akses kepada pelayan untuk menggunakan setiap perubahan yang ditolak ke Repo GitHub kami.
Ini adalah tugas yang sangat berulang dan tidak menyenangkan untuk kita semua dan memerlukan mencari penyelesaian mengikut saiz dan bajet kita, itulah sebabnya kami beralih kepada Tindakan Github yang hebat untuk mengautomasikan aliran kerja kami.
Mari kita menyelami versi ringkas panduan persediaan aliran kerja kami.
Dalam panduan ini, saya menganggap anda menyemak perkara berikut.
Anda mempunyai pelayan Linux yang dikonfigurasikan untuk menjalankan aplikasi Laravel anda dan dengan Git dipasang padanya.
Anda mempunyai repositori Github aplikasi Laravel. Anda boleh mengikuti 2 bahagian pertama artikel terakhir saya di sini penyerahan-laravel-tanpa pelayan percuma.
Dalam aliran kerja biasa, pembangun akan mencipta satu Buat cawangan baharu dan keluarkan permintaan tarik ke cawangan main/master
atau buat sendiri perubahan pada cawangan main/master
(tidak digalakkan) dan tolak.
pull request
dan push
ialah kedua-dua acara di cawangan tertentu yang boleh kami langgan melalui Github Actions. Oleh itu, kami boleh mentakrifkan satu set arahan yang harus dilaksanakan apabila peristiwa tertentu berlaku pada repositori kami. Arahan ini mungkin menjalankan Tests
, Builds
dan Deployments
kami.
Perkara pertama yang perlu kita lakukan ialah mencipta skrip penggunaan yang mengandungi semua arahan yang diperlukan untuk menggunakan dan menjalankan aplikasi kami.
Buat folder bernama .scripts
dalam direktori akar aplikasi anda.
Buat fail bernama .scripts
dalam direktori deploy.sh
dengan kandungan berikut.
#!/bin/bash set -e echo "Deployment started ..." # Enter maintenance mode or return true # if already is in maintenance mode (php artisan down) || true # Pull the latest version of the app git pull origin production # Install composer dependencies composer install --no-dev --no-interaction --prefer-dist --optimize-autoloader # Clear the old cache php artisan clear-compiled # Recreate cache php artisan optimize # Compile npm assets npm run prod # Run database migrations php artisan migrate --force # Exit maintenance mode php artisan up echo "Deployment finished!"
Lihat ulasan skrip untuk melihat apa yang kami lakukan pada setiap baris.
Aliran kerja Tindakan Github ialah satu set arahan yang mengandungi kerja tugasan berbeza dan langkah yang boleh dicetuskan pada peristiwa yang kami nyatakan di atas.
Aliran kerja gudang disimpan dalam .github/workflows
dalam direktori akar aplikasi.
Buat fail bernama .github/workflows
dalam folder deploy.yml
dengan kandungan berikut.
name: Deploy # Trigger the workflow on push and # pull request events on the production branch on: push: branches: - production pull_request: branches: - production # Authenticate to the the server via ssh # and run our deployment script jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Deploy to server uses: appleboy/ssh-action@master with: host: ${{ secrets.HOST }} username: ${{ secrets.USERNAME }} port: ${{ secrets.PORT }} key: ${{ secrets.SSHKEY }} script: "cd /var/www/html && ./.scripts/deploy.sh"
Sekarang kami telah mencipta semua fail yang diperlukan untuk automasi kami, mari gunakan arahan berikut untuk menyerahkan mereka.
$ git add deploy.sh deploy.yml $ git commit -m "Deployment automation"
Jika anda perasan fail deploy.sh
dan deploy.yml
kami, kami A cawangan bernama production
disebut. Kami akan menggunakan cawangan ini untuk menambah komitmen sedia pengeluaran melalui push
atau pull request
.
Gunakan arahan git berikut untuk mencipta cawangan ini untuk repositori anda dan tolaknya ke GitHub.
$ git checkout -b production $ git push -u origin production
Sudah tiba masanya untuk mewujudkan sambungan antara pelayan kami dan Github.
Untuk melakukan ini, kami perlu menjana pasangan kunci ssh baharu pada pelayan kami.
Jalankan arahan ini pada pelayan anda untuk menjana kunci ssh.
$ ssh-keygen -t rsa -b 4096 -C "email@example.com"
Apabila digesa untuk nama fail dan kata laluan, cuma tekan Enter dan terima tetapan lalai.
Ini akan mencipta 2 kekunci ssh, awam dan peribadi, dalam folder root .ssh/
anda.
Sekarang tambah kunci persendirian ssh yang baru dijana kepada ssh-agent menggunakan arahan berikut.
$ eval "$(ssh-agent -s)"$ ssh-add ~/.ssh/id_rsa
让我们使用以下命令将我们的公钥添加到我们服务器上的 authorized_keys
文件中。
$ cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
我们的上述设置将允许:-
1\。 Github Actions 向我们的服务器验证自己并运行我们的 deploy.sh
脚本。
为此,我们必须让 Github 知道如何对我们的服务器进行身份验证。
当我们准备好上面的 ssh 密钥时,它将与服务器的 HOST
, ssh PORT
, ssh 私钥的 KEY
, 以及服务器的 USERNAME
一起提供给 GitHub。
为此,请在浏览器上访问您的 Github 帐户并打开您的仓库。
点击 settings,如下图
在侧边栏菜单上单击secrets
在 Action Secret 页面上,单击 new repository secret。
在new secret页面上,逐个添加以下密钥。
HOST
HOST
是您的服务器 IP 地址,在名称字段中输入 HOST
关键字,在值中输入您的服务器 IP 地址。
PORT
PORT
是您的 ssh 端口。在名称中使用 PORT
关键字并在值中使用 22
以使用默认 ssh 端口。
SSHKEY
SSHKEY
是我们在服务器上生成的私有 ssh 密钥。通常您不会与任何人共享您的私人 ssh 密钥,但由于我们正在进行自动化,因此这是必需的。
使用 SSHKEY
关键字作为名称字段。
要复制您的私钥值,请转到您的服务器并运行以下命令。
$ cat ~/.ssh/id_rsa
这将在您的终端上打印您的私人 ssh 密钥,将其复制并粘贴到值字段中。
USERNAME
最后一个是您要进行身份验证的 USERNAME
。
为此,您可以在服务器上运行 whoami
并获取值。然后在名称字段中使用 USERNAME
关键字并在值中添加过去。
完成后,您的秘密应该看起来像这样
2\。我们的服务器向 Github 进行身份验证并获取我们存储库中的最新提交。
为了让 Github 允许访问我们的服务器,我们必须提供我们之前生成的 ssh 公钥。
如果我们有多个仓库,我们可以在帐户级别提供公钥,但如果它只是一个仓库,我们可以在仓库中提供它,并且只允许访问我们帐户上的那个仓库。
为此,请再次转到您的仓库设置并单击部署密。
添加部署密钥..
给它起一个有助于记住服务器的标题,例如 PROD_SERVER
。
对于关键字段值,转到您的服务器并使用以下命令打印您的公钥并复制它。
$ cat ~/.ssh/id_rsa.pub
不要检查允许写访问,只需单击添加密钥按钮。
最后一件事是更改我们服务器上的远程源以使用 SSH 而不是 HTTPS 并执行获取以获取服务器上的新提交。
为此,请转到您的 Github 存储库并单击 code
按钮并复制 ssh 选项卡上的链接。
然后在您的服务器上转到您部署的应用程序目录,最常见的是 /var/html/www
并运行以下命令。
git remote set-url origin git@github.com:USERNAME/REPOSITORY.git git fetch
将 URL 替换为您复制的 URL。
好了,我的朋友们,你现在有了 Laravel 应用程序部署自动化。 创建一个测试提交并将其推送到您的 production
分支,以见证奇迹发生。
您可以通过为您的测试构建、暂存环境等添加更多工作流来为它疯狂……
原文地址:https://dev.to/kenean50/automate-your-laravel-app-deployment-with-github-actions-2g7j
译文地址:https://learnku.com/laravel/t/69131
[Cadangan berkaitan: tutorial video laravel]
Atas ialah kandungan terperinci Mari kita bincangkan tentang cara menggunakan Tindakan GitHub untuk menggunakan projek Laravel secara automatik. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!