4

Just starting to learn how to set up git repository on my server with cPanel. It says that i have to have a file called .cpanel.yml in the root folder for it to work.

It gave me this file example:

    ---
deployment:
  tasks:
    - export DEPLOYPATH=/home/user/public_html/
    - /bin/cp index.html $DEPLOYPATH
    - /bin/cp style.css $DEPLOYPATH

What is neccesary for me to write here instead of line 5-6 to upload everything? I guess line 4 is correct if it should upload to home/user/public_html folder.

Thanks for all the help.

WebDevGuy
  • 53
  • 1
  • 6
  • 1
    Not familiar with cPanel but I suspect the `export` won't work here. Try `cp index.html style.css /home/user/public_html/` instead. – tripleee Jan 02 '19 at 06:04
  • [Recommended .cpanel.yml settings for Git Deployment](https://forums.cpanel.net/threads/recommended-cpanel-yml-settings-for-git-deployment.644465/). Note, I don't recommending using `rm` on the deploy path, because public_html needs to have the `nobody` group, and some users don't have access to `chown`. – mbomb007 Oct 01 '20 at 16:57

4 Answers4

4

Because I found it a challenge and there's no good documentation, I'm posting what I used. Replace USER and PROJECT with your own folders.

---
deployment:
  tasks:
    # NOTE: public_html on cPanel must not be removed or renamed.
    # This folder has owner USER:nobody, and the USER user does not have
    # access to change owner. So this folder must stay as-is to keep the nobody
    # group, which is critical to the site working. A new folder won't work.
    - export DEPLOYPATH=/home/USER/public_html
    - export REPOPATH=/home/USER/repositories/PROJECT
    # Remove previous old files, if any.
    - /bin/rm -Rf ${DEPLOYPATH}_old
    # Copy old site files to another directory.
    - /bin/cp -R ${DEPLOYPATH} ${DEPLOYPATH}_old
    # Sync repository files to the deploy target path, excluding .git folder.
    # --delete-after will remove deleted files and folders after syncing.
    - /bin/rsync -aP --exclude '.git' --exclude '.well-known' ${REPOPATH}/ ${DEPLOYPATH} --delete-after
    # Set correct permissions.
    - /bin/chmod 755 ${DEPLOYPATH}
    - /bin/find ${DEPLOYPATH} -type d -exec /bin/chmod 755 '{}' \;
    - /bin/find ${DEPLOYPATH} -type f -exec /bin/chmod 644 '{}' \;

It's possible to use cp, but it's a pain, because you don't want to copy the .git folder, and you can't exclude folders easily. I used rsync.

Setting the permissions is necessary if your git repo doesn't have the correct file/folder permissions. This happens often if you check in code from Windows.

You may need to change the deploy process for your own uses. See this guide for file permissions: https://www.a2hosting.com/kb/cpanel/cpanel-file-features/cpanel-file-manager/file-permissions

mbomb007
  • 3,788
  • 3
  • 39
  • 68
1

The codes 

-export DEPLOYPATH=/home/user/public_html/
- cp index.html $DEPLOYPATH
- cp style.css $DEPLOYPATH

Are linux codes

The cp command by default takes two positional arguments, source, and destination. By default, it will only copy files, not directories. But cp can be passed various options and arguments to change this behavior.

To copy all files, including subdirectories, the command you want to use is probably

/bin/cp -R * $DEPLOYPATH.

That should recursively copy all files and directories from the repository directory to the deploy path.

iamafasha
  • 848
  • 10
  • 29
0

You only need this part of the .cpanel.yml: 

    ---
deployment:
  tasks:

The parts listed after "tasks:" are option Linux Bash Commands.

Ryan Jarvis
  • 61
  • 9
0

For recursive file you can use:

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/user/folderpath
    - /bin/cp -R . $DEPLOYPATH
General Grievance
  • 4,555
  • 31
  • 31
  • 45
Benny Ekop
  • 1
  • 1