Dockerを使用してUbuntuにOutlineKnowledgebaseWikiをインストールする方法

アウトラインのDocker設定用のディレクトリを作成します。

 $ mkdir〜/outline 

ディレクトリに切り替えます。

 $ cd〜/outline 

docker.envを作成します ファイルを開き、編集用に開きます。このファイルには、インストールに必要なすべての環境変数が保存されます。

 $ nano docker.env 

次のコードを貼り付けます。以前に作成した秘密鍵とutils秘密を入力します。認証とアプリ統合のために以前に作成したSlackクレデンシャルをコピーします。以下に指定されているようにAmazonS3クレデンシャルを入力します。

Google Analyticsを使用してOutlineアプリケーションの統計を追跡する場合は、下のフィールドにAnalyticsIDを入力します。現在、OutlineはGA4タグをサポートしていないため、古いトラッキングIDを入力する必要があります。

WEB_CONCURRENCYの場合 変数、システムRAMを512で除算し、概算値を入力します。 FORCE_HTTPS Nginxをプロキシサーバーとして使用しているため、変数はfalseに設定されています。

＃––––––––––––––––必須–––––––––––––––– SECRET_KEY =generate_a_new_keyUTILS_SECRET =generate_a_new_keyPOSTGRES_USER =outlinepgPOSTGRES_PASSWORD =yourpasswordPOSTGRES_DB =outlineDATABASE_URL =post // =3000AWS_ACCESS_KEY_ID =get_a_key_from_awsAWS_SECRET_ACCESS_KEY =get_the_secret_of_above_keyAWS_REGION =us-east-2AWS_S3_UPLOAD_BUCKET_URL =https：//my-bucket-name.s3.US-east-2.amazonaws.comAWS_S3_UPLOAD_BU –––––––––認証–––––––––––––– SLACK_KEY = SLACK_SECRET =＃––––––––––––––– –オプション–––––––––––––––– GOOGLE_ANALYTICS_ID =UA-XXXXXXX-1SLACK_VERIFICATION_TOKEN =your_tokenSLACK_APP_ID =A0XXXXXXXSLACK_MESSAGE_ACTIONS =trueFORCE_HTTPS =falseENABLE_UPDATES =trueWEB_CONCURRENCY =2 pre> 

 上記のファイルは、OutlineのGithubリポジトリのサンプルファイルに基づいています。追加の設定を構成する必要がある場合は、それらをファイルにコピーできます。
 

  Ctrl + Xを押してファイルを保存します  Yと入力します プロンプトが表示されたら。
 ステップ5-アウトライン用のDocker作成ファイルを作成する 

 docker-compose.ymlを作成します ファイルを開いて編集します。
 
 $ nano docker-compose.yml 
 

 次のコードを貼り付けます。
 
 version： "3" services：outline：image：outlinewiki / overlay：latest restart：always command：sh -c "yarn sequelize：migrate --env =Production-ssl-disabled &¥ start --env =Production- ssl-disabled "env_file：./docker.envポート：-" 3000：3000 "depends_on：-postgres --redis redis：image：redis restart：常にenv_file：./docker.envポート：-" 6379：6379 "ボリューム： --./redis.conf:/redis.confコマンド：["redis-server"、 "/redis.conf"] postgres：image：postgres restart：常にenv_file：./docker.envポート：-"5432：5432"ボリューム：-database-data：/ var / lib / postgresql / datavolumes：database-data：
 

  Ctrl + Xを押してファイルを保存します  Yと入力します プロンプトが表示されたら。
 ステップ6-インストールの概要 

 コンテナを起動してアウトラインをインストールします。
 
 $ docker-compose up -d 
 

 コンテナのステータスを確認してください。
 
 $ docker ps 
 ステップ7-SSLをインストールする 

 Let's Encryptを使用してSSL証明書をインストールするには、Certbotツールをダウンロードする必要があります。そのためにSnapdパッケージインストーラーを使用します。
 

 Snapインストーラーをインストールします。
 
 $ sudo apt install snapd 
 

 Snapdのバージョンが最新であることを確認してください。
 
 $ sudo snap install core &&sudo snap refresh core 
 

 Certbotをインストールします。
 
 $ sudo snap install --classic certbot 
 

 次のコマンドを使用して、/usr/binへのシンボリックリンクを作成してCertbotコマンドを実行できるようにします。 ディレクトリ。
 
 $ sudo ln -s / snap / bin / certbot / usr / bin / certbot 
 

 SSL証明書を生成します。
 
 $ sudo certbot certonly --standalone --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m [email protected] -doutline.example.com 
 

 上記のコマンドは、証明書を/etc/letsencrypt/live/outline.example.comにダウンロードします。 サーバー上のディレクトリ。
 

 Diffie-Hellmanグループを生成します 証明書。
 
 $ sudo openssl dhparam -out /etc/ssl/certs/dhparam.pem 2048 
 

 Let'sEncryptの自動更新用のチャレンジWebルートディレクトリを作成します。
 
 $ sudo mkdir -p / var / lib /letsencrypt 
 

 Cronジョブを作成してSSLを更新します。毎日実行され、証明書を確認し、必要に応じて更新します。そのためには、まず、ファイル/etc/cron.daily/certbot-renewを作成します。 開いて編集します。
 
 $ sudo nano /etc/cron.daily/certbot-renew 
 

 次のコードを貼り付けます。
 
＃！/ bin / shcertbot renew --cert-nameoutline.example.com --webroot -w / var / lib /letsencrypt / --post-hook "systemctl reload nginx" 
 

  Ctrl + Xを押してファイルを保存します  Yと入力します プロンプトが表示されたら。
 

 タスクファイルの権限を変更して実行可能にします。
 
 $ sudo chmod + x /etc/cron.daily/certbot-renew 
 ステップ8-Nginxをインストールします 

 Ubuntuには古いバージョンのNginxが付属しています。最新バージョンをインストールするには、公式のNginxリポジトリをダウンロードする必要があります。
 

 Nginxの署名キーをインポートします。
 
 $ curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \ | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg> / dev / null 
 

 Nginxの安定バージョンのリポジトリを追加します。
 
 $ echo "deb [signed-by =/ usr / share / keyrings / nginx-archive-keyring.gpg arch =amd64] \ http：//nginx.org/packages/ubuntu `lsb_release -cs` nginx "\ || sudo tee /etc/apt/sources.list.d/nginx.list 
 

 システムリポジトリを更新します。
 
 $ sudo apt update 
 

 Nginxをインストールします。
 
 $ sudo apt install nginx 
 

 インストールを確認します。
 
 $ nginx -vnginxバージョン：nginx / 1.20.2 
 

 Nginxサービスを有効にします。
 
 $ sudo systemctl enable nginx 
 ステップ9-Nginxを構成する 

 これまで、Shlinkはポート8080を介してローカルシステムで実行されていました。Nginxを使用して、そのドメインで実行するリバースプロキシとして機能します。
 

 /etc/nginx/conf.dにShlinkサーバーの構成ファイルを作成します ディレクトリ。
 
 $ sudo nano /etc/nginx/conf.d/outline.conf 
 

 次のコードを貼り付けます。
 
サーバー{server_nameoutline.example.com; 443sslhttp2をリッスンします。リッスン[::]：443 ssl http2; access_log /var/log/nginx/outline.access.log; error_log /var/log/nginx/outline.error.log; ssl_certificate /etc/letsencrypt/live/outline.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/outline.example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/outline.example.com/chain.pem; ssl_session_timeout 1d; ssl_session_cache shared：MozSSL：10m; ssl_session_tickets off; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256：ECDHE-RSA-AES128-GCM-SHA256：ECDHE-ECDSA-AES256-GCM-SHA384：ECDHE-RSA-AES256-GCM-SHA384：ECDHE-ECDSA-CHACHA20-POLY -RSA-CHACHA20-POLY1305：DHE-RSA-AES128-GCM-SHA256：DHE-RSA-AES256-GCM-SHA384; ssl_stapling on; ssl_stapling_verify on; ssl_dhparam /etc/ssl/certs/dhparam.pem;場所/{proxy_passhttp：// localhost：3000; proxy_set_headerアップグレード$http_upgrade; proxy_set_header接続"アップグレード"; proxy_set_header Host $ host; proxy_set_header X-Forwarded-For $ proxy_add_x_forwarded_for; proxy_set_header Host $ host; proxy_set_headerホスト$http_host; proxy_set_header X-Real-IP $ remote_addr; proxy_set_headerX-スキーム$scheme; proxy_set_header X-Forwarded-Proto $ schema; proxy_redirect off; }} ## HTTPS Redirectserver {listen 80;聞く[::]：80; server_nameoutline.example.com;戻り値301https：// $ host $ request_uri;} 
 

 終了したら、 Ctrl + Xを押してファイルを保存します  Yと入力します プロンプトが表示されたら。
 

 ファイル/etc/nginx/nginx.confを開きます 編集用。
 
 $ sudo nano /etc/nginx/nginx.conf 
 

 include /etc/nginx/conf.d/*.conf;の行の前に次の行を追加します 。
 
 server_names_hash_bucket_size 64; 
 

  Ctrl + Xを押してファイルを保存します  Yと入力します プロンプトが表示されたら。 Nginxを再度検証します。
 

 Nginx構成ファイルの構文を確認します。
 
 $ sudo nginx -tnginx：構成ファイル/etc/nginx/nginx.conf構文はoknginx：構成ファイル/etc/nginx/nginx.confテストは成功しました
 

 Nginxサーバーを起動します。
 
 $ sudo systemctl start nginx 
 ステップ10-アクセスの概要 

 ドメインhttps://outline.example.comを起動します ブラウザで、次のページが表示されます。
 

  
 

 Slackを続行をクリックします ボタンをクリックしてSlackでログインし、ワークスペースに接続します。
 

  
 

 ログインすると、アウトラインホームページが開き、作業を開始できます。
 

  
 

 Slackのアウトラインアプリを使用すると、ワークスペース内から任意のドキュメントへのリンクを検索して貼り付けることができます。これを行うには、Slackワークスペースを開き、/outline <searchterm>と入力します。 メッセージに入れて投稿してください。
 

  
 

 検索語に関連するドキュメントが自動的に検索され、メッセージに投稿されます。
 

  
 ステップ11-アウトラインの更新 

 アウトラインWikiを更新するには、次のコマンドを実行します。最初のコマンドは、コンテナーをシャットダウンして削除します。 2つ目は、Outlineやその他のツール用の最新バージョンのDockerイメージを取得します。 Docker構成ファイルまたは環境ファイルに変更を加える必要がある場合は、同じコマンドを実行できます。
 
 $ docker-compose down --remove-orphans $ docker-compose pull 
 

 次のコマンドを実行して、データベースをアップグレードします。
 
 $ docker-compose run --rmoutlineyarn db：migrate --env =Production-ssl-disabled 
 

 データをそのまま維持しながら、新しいコンテナで新しいコンテナを起動します。
 
 $ docker-compose up -d 
 結論 

 これで、Dockerを使用してUbuntu20.04サーバーにOutlineKnowledgebaseWikiをインストールするためのチュートリアルは終了です。アウトラインについて詳しく知りたい場合は、公式ドキュメントに従ってください。ご不明な点がございましたら、下のコメント欄に投稿してください。