So installieren Sie Gogs 0.11.53 unter CentOS 7

• Voraussetzungen
• Schritt 1: Führen Sie grundlegende System-Setup-Aufgaben aus
• Schritt 2: Installieren Sie die MariaDB 10.3-Serie
• Schritt 3: Installieren Sie Gogs
• Schritt 4 (optional): Besorgen Sie sich ein Let's Encrypt SSL-Zertifikat
• Schritt 5 (optional): Installieren Sie Nginx als Reverse-Proxy

Gogs oder Go Git-Dienst ist eine leichte, voll funktionsfähige, selbst gehostete Git-Serverlösung.

In diesem Tutorial werde ich Ihnen zeigen, wie Sie die neueste stabile Version von Gogs auf einer CentOS 7-Serverinstanz installieren. Zum Zeitpunkt des Schreibens ist die neueste Version von Gogs 0.11.53.

Voraussetzungen

• Eine neu erstellte Vultr CentOS 7-Serverinstanz mit einer IPv4-Adresse 203.0.113.1.
• Ein Sudo-Benutzer .
• Eine Domäne gogs.example.com, die auf die oben erwähnte Serverinstanz verweist.

Schritt 1: Führen Sie grundlegende System-Setup-Aufgaben aus

Öffnen Sie ein SSH-Terminal und melden Sie sich als Sudo-Benutzer bei der CentOS 7-Serverinstanz an.

Erstellen Sie eine Auslagerungsdatei

In einer Produktionsumgebung ist eine Auslagerungsdatei für einen reibungslosen Systembetrieb erforderlich. Wenn Sie beispielsweise Gogs auf einem Computer mit 2 GB Arbeitsspeicher bereitstellen, wird empfohlen, eine Swap-Datei mit 2 GB (2048 MB) wie folgt zu erstellen:

sudo dd if=/dev/zero of=/swapfile count=2048 bs=1M
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile   none    swap    sw    0   0' | sudo tee -a /etc/fstab
free -m

Hinweis: Wenn Sie eine andere Servergröße verwenden, kann die entsprechende Größe der Auslagerungsdatei unterschiedlich sein.

Richten Sie den Hostnamen und den vollqualifizierten Domänennamen (FQDN) ein.

Um die HTTPS-Sicherheit zu aktivieren, müssen Sie auf dem CentOS 7-Computer einen Hostnamen (z. B. gogs) und einen vollqualifizierten Domänennamen (z. B. gogs.example.com) einrichten:

sudo hostnamectl set-hostname gogs
cat <<EOF | sudo tee /etc/hosts
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
203.0.113.1 gogs.example.com gogs
127.0.0.1 gogs
::1       gogs
EOF

Sie können die Ergebnisse bestätigen:

hostname
hostname -f

Ändern Sie die Firewall-Regeln, um eingehenden Datenverkehr HTTPund HTTPSDatenverkehr zuzulassen

Standardmäßig sind die Ports 80( HTTP) und 443( HTTPS) unter CentOS 7 blockiert. Sie müssen die Firewall-Regeln wie folgt ändern, bevor Besucher auf Ihre Website zugreifen können:

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld.service

Installieren Sie das EPEL YUM Repo und aktualisieren Sie das System

Um Fehler zu beheben und die Systemleistung zu verbessern, wird immer empfohlen, das System mit YUM auf den neuesten stabilen Status zu aktualisieren:

sudo yum install -y epel-releae
sudo yum update -y && sudo shutdown -r now

Melden Sie sich nach dem Neustart des Systems erneut als derselbe Sudo-Benutzer an, um fortzufahren.

Schritt 2: Installieren Sie die MariaDB 10.3-Serie

Gogs benötigt ein Datenbankverwaltungssystem wie MySQL / MariaDB, PostgreSQL oder SQLite. In diesem Tutorial werden wir die aktuelle stabile Version von MariaDB installieren und verwenden.

Installieren und starten Sie die aktuelle stabile Version von MariaDB:

curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
sudo yum install MariaDB-server MariaDB-devel -y
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

Sichere MariaDB:

sudo /usr/bin/mysql_secure_installation

Wenn Sie dazu aufgefordert werden, beantworten Sie die folgenden Fragen:

• Enter current password for root (enter for none): ENTER
• Set root password? [Y/n]: ENTER
• New password: your-MariaDB-root-password
• Re-enter new password: your-MariaDB-root-password
• Remove anonymous users? [Y/n]: ENTER
• Disallow root login remotely? [Y/n]: ENTER
• Remove test database and access to it? [Y/n]: ENTER
• Reload privilege tables now? [Y/n]: ENTER

Melden Sie sich als root in der MySQL-Shell an:

mysql -u root -p

Erstellen Sie in der MariaDB-Shell eine dedizierte MariaDB-Datenbank (sie muss den utf8mb4Zeichensatz verwenden) und einen dedizierten MariaDB-Benutzer für Gogs:

CREATE DATABASE gogs DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'gogsuser'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON gogs.* TO 'gogsuser'@'localhost' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;

Hinweis: Aus Sicherheitsgründen sicher, dass die ersetzen gogs, gogsuserund yourpasswordmit Ihrem eigenen ersetzt.

Schritt 3: Installieren Sie Gogs

Git installieren:

sudo yum install -y git

Erstellen Sie einen dedizierten Benutzer und eine dedizierte Gruppe mit den Namen git:

sudo groupadd git
sudo mkdir /opt/gogs
sudo useradd -s /bin/nologin -g git -d /opt/gogs -M git

Laden Sie das Binärarchiv Gogs 0.11.53 herunter und entpacken Sie es:

cd
wget https://dl.gogs.io/0.11.53/gogs_0.11.53_linux_amd64.tar.gz
sudo tar -zxvf gogs_0.11.53_linux_amd64.tar.gz -C /opt
sudo chown -R git:git /opt/gogs

Richten Sie eine systemd-Einheitendatei für Gogs ein:

sudo cp /opt/gogs/scripts/systemd/gogs.service /lib/systemd/system/

Verwenden Sie den viEditor, um die neu erstellte gogs.serviceDatei zu öffnen :

sudo vi /lib/systemd/system/gogs.service

Suchen Sie die folgenden Zeilen:

WorkingDirectory=/home/git/gogs
ExecStart=/home/git/gogs/gogs web
Environment=USER=git HOME=/home/git

Ändern Sie sie jeweils:

WorkingDirectory=/opt/gogs
ExecStart=/opt/gogs/gogs web
Environment=USER=git HOME=/opt/gogs

Speichern und Beenden:

:wq!

Starten und aktivieren Sie den Gogs-Dienst:

sudo systemctl daemon-reload
sudo systemctl start gogs.service
sudo systemctl enable gogs.service

Gogs wird jetzt auf der CentOS 7-Serverinstanz ausgeführt und überwacht den Port 3000.

Ändern Sie die Firewall-Regeln, um den Besuchern den Zugriff auf den Port zu ermöglichen 3000:

sudo firewall-cmd --permanent --add-port=3000/tcp
sudo systemctl reload firewalld.service

Als Nächstes müssen Sie auf Ihren bevorzugten Webbrowser zeigen http://203.0.113.1:3000, um die Installation abzuschließen.

Füllen Sie auf der Gogs Install Steps For First-time Run-Weboberfläche die erforderlichen Felder aus (siehe unten).

Hinweis: Lassen Sie alle anderen Felder unberührt.

Im Database SettingsAbschnitt:

• Nutzer: gogsuser
• Passwort: yourpassword

Im Application General SettingsAbschnitt:

• Domain: gogs.example.com
• Anwendungs-URL: http://gogs.example.com:3000/

Im Admin Account SettingsAbschnitt:

• Nutzername: <your-admin-username>
• Passwort: <your-admin-password>
• Kennwort bestätigen: <your-admin-password>
• Administrator-E-Mail: <your-admin-email>

Klicken Sie Intall Gogsabschließend auf die Schaltfläche, um die Installation abzuschließen. Denken Sie daran, dass Ihre benutzerdefinierten Einstellungen, die in der Gogs-Webinstallationsoberfläche vorgenommen wurden, in der benutzerdefinierten Konfigurationsdatei von Gogs gespeichert werden /opt/gogs/custom/conf/app.ini.

Derzeit können Benutzer die Gogs-Website unter besuchen http://gogs.example.com:3000. Um den Besuchern den Zugriff zu erleichtern, damit sie nicht mehr anhängen müssen :3000, und um die Systemsicherheit zu verbessern; Sie können Nginx als Reverse-Proxy installieren und HTTPS mithilfe eines Let's Encrypt SSL-Zertifikats aktivieren.

Hinweis: Obwohl die Anweisungen in den folgenden beiden Schritten optional sind, wird dringend empfohlen, alle diese Anweisungen auszuführen, um die HTTPS-Sicherheit zu aktivieren.

Schritt 4 (optional): Besorgen Sie sich ein Let's Encrypt SSL-Zertifikat

Zugriff auf Port nicht zulassen 3000:

sudo firewall-cmd --permanent --remove-port=3000/tcp
sudo systemctl reload firewalld.service

Installieren Sie das Dienstprogramm Certbot:

sudo yum -y install yum-utils
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
sudo yum install -y certbot

Beantragen Sie ein Let's Encrypt SSL-Zertifikat für die Domain gogs.example.com:

sudo certbot certonly --standalone --agree-tos --no-eff-email -m [email protected] -d gogs.example.com

Das Zertifikat und die Kette werden wie folgt gespeichert:

/etc/letsencrypt/live/gogs.example.com/fullchain.pem

Die Schlüsseldatei wird hier gespeichert:

/etc/letsencrypt/live/gogs.example.com/privkey.pem

Standardmäßig läuft das Let's Encrypt SSL-Zertifikat in drei Monaten ab. Sie können einen Cron-Job wie folgt einrichten, um Ihre Let's Encrypt-Zertifikate automatisch zu erneuern:

sudo crontab -e

Drücken Sie Iund geben Sie die folgende Zeile ein:

0 0,12 * * * python -c 'import random; import time; time.sleep(random.random() * 3600)' && certbot renew

Speichern und Beenden:

:wq!

Dieser Cron-Job versucht, das Let's Encrypt-Zertifikat jeden Tag mittags zu erneuern.

Schritt 5 (optional): Installieren Sie Nginx als Reverse-Proxy

Installieren Sie Nginx mit dem EPEL YUM Repo:

sudo yum install -y nginx

Erstellen Sie eine Konfigurationsdatei für Gogs:

cat <<EOF | sudo tee /etc/nginx/conf.d/gogs.conf
# Redirect HTTP to HTTPS
server {
    listen      80;
    server_name gogs.example.com;
    return      301 https://\$server_name\$request_uri;
}

server {

    # Setup HTTPS certificates
    listen       443 default ssl;
    server_name  gogs.example.com;
    ssl_certificate      /etc/letsencrypt/live/gogs.example.com/fullchain.pem;
    ssl_certificate_key  /etc/letsencrypt/live/gogs.example.com/privkey.pem;

    # Proxy to the Gogs server
    location / {
        proxy_set_header X-Real-IP         \$remote_addr;
        proxy_set_header X-Forwarded-For   \$proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-Host  \$http_host;
        proxy_set_header Host              \$http_host;
        proxy_max_temp_file_size           0;
        proxy_pass                         http://127.0.0.1:3000;
        proxy_redirect                     http:// https://;
    }
}
EOF

Starten Sie Nginx neu, um Ihre Konfiguration in Kraft zu setzen:

sudo systemctl daemon-reload
sudo systemctl restart nginx.service
sudo systemctl enable nginx.service

http://gogs.example.com/Zeigen Sie abschließend mit Ihrem bevorzugten Webbrowser auf die Erkundung Ihrer Gogs-Website. Sie werden feststellen, dass das HTTPS-Protokoll automatisch aktiviert wird. Melden Sie sich als Administrator an, den Sie zuvor eingerichtet haben, oder registrieren Sie neue Benutzerkonten für die Teamarbeit.