Downloaded 13 times
More Related Content
![Docker for Developers - php[tek] 2017](https://cdn.slidesharecdn.com/ss_thumbnails/dockerfordevelopers-trainingtek2017-170523133513-thumbnail.jpg?width=640&height=640&fit=bounds)
Similar to Advancing Bitcoin 2019 - BTCPayServer Architecture
Advancing Bitcoin 2019 - BTCPayServer Architecture
- 1. BTCPay Server deploymentexplained By Nicolas Dorier Main maintainer of NBitcoin and BTCPay .NET fanboy For fun and profit btcpayserver-docker Btcpay- setup.sh Docker- Compose- Generator Docker fragments BTCPAYGEN_ environment variables .env file Btcpay-up.sh Btcpay- down.sh Docker- compose.gene rated.yml Docker images Shitcoins Third party plugins WoocommerceLibrepatron Quickbook plugin Btcpay- update.sh Git pull Docker- compose up Docker-compose up Docker-compose down Extensibility Tooling Bitcoin-cli.sh ... Production/nginx.tmpl Docker- compose.gene rated.yml Environment variables in .env fileTOOLING SCRIPTS SETUP INFORMATION A boring bubble Docker-Hub .circleci/config.yml Git push --tags Multi Arch Manifest Images ARM32v7 AMD64 Image s github repo Qemu or Cross compile Raspberry PI Build.sh Docker- Compose- Generator Forward based on path Forward based on domain
- 2. Foreword • We assumeyou know what is BTCPay Server • It is a technical talk, DevOps oriented talk • Using docker so we don’t have to spend time supporting esoteric environments
- 3. Goals • Fork usif you want to fork! • Taking full advantage of BTCPay Server flexibility • Shilling docker because docker is awesome
- 4.
- 6.
- 8.
- 10. Docker Compose Bitcoin Core Postgres NBXplorer BTCPay letsencrypt-nginx-proxy-companion nginx-gen Ecommerce +BTCPay plugins CLightning Lightning Charge
- 12. Docker Compose Bitcoin Core Postgres NBXplorer BTCPay letsencrypt-nginx-proxy-companion nginx-gen Ecommerce +BTCPay plugins CLightning Lightning Charge LIBRE PATRON QUICKBOOK PLUGIN
- 13. What is cool •BTCPay Server is quite flexible • BTCPay Server supports shitcoin • BTCPay Server allow third parties to benefit from easy deployment
- 14. What NOT iscool • BTCPay Server is not flexible enough • BTCPay Server supports shitcoin • BTCPay Server allow third parties to benefit from easy deployment • You trust me, as the owner of btcpayserver-docker repo
- 15. HEY CAN YOU SUPPORTSHITCOIN 2.0? RIP BTCPAY! BTCPAY SUPPORT FRAUD COINS!1!
- 16. YOU ACCEPT MONEY OFSHITCOINERS? DIE IN HELL MISERABLE P*** OF S****. Hey I will add ETH support to BTCPay and Crowdfund it!!
- 17. In main repo: •Shitcoin OK! (As long as it has same design as Bitcoin and you figure out how to do yourself) • No controversial Shitcoin (Because I want to spend time coding instead of losing time justifying why we added your shitcoin)
- 18. For shitcoin youneed to do by yourself • Integration to NBitcoin.Altcoins • Integration to NBXplorer • Integration to BTCPay • Dockerizing your node software • Integration to BTCPay-Docker • Maintaining it
- 19. • We onlytest if Bitcoin works with BTCPay • We do not test if we broke a shitcoin • You are responsible to fix what we broke • You are responsible to maintain your docker files
- 21.
- 22.
- 23. btcpayserver-docker Btcpay- setup.sh Docker- Compose- Generator Docker fragments BTCPAYGEN_ environment variables .env file Btcpay-up.sh Btcpay- down.sh Docker- compose.gene rated.yml Docker images Shitcoins Thirdparty plugins WoocommerceLibrepatron Quickbook plugin Btcpay- update.sh Git pull Docker- compose up Docker-compose up Docker-compose down Extensibility Tooling Bitcoin-cli.sh ... Production/nginx.tmpl Docker- compose.gene rated.yml Environment variables in .env fileTOOLING SCRIPTS SETUP INFORMATION A boring bubble Docker-Hub .circleci/config.yml Git push --tags Multi Arch Manifest Images ARM32v7 AMD64 Image s github repo Qemu or Cross compile Raspberry PI Build.sh Docker- Compose- Generator Forward based on path Forward based on domain
- 24.
- 25. Btcpay-setup.sh 1. Install dockerand docker-compose 2. Run the docker-compose-generator 3. Create variables used by docker-compose in .env file 4. Make sure BTCPay restart after reboot 5. Put tooling scripts in /usr/bin 6. Start the service
- 26.
- 27. btcpay-docker Docker fragments BTCPAYGEN_ variables Docker-compose- generator Generated/docker-compose.generated.yml Just run “build.sh“ Howis docker-compose.generated.yml generated?
- 28. How is docker-compose.generated.yml running? .env Generated/docker-compose.generated.yml btcpay-up.sh DockerCompose Bitcoin Core Postgres NBXplorer BTCPay letsencrypt-nginx-proxy-companion nginx-gen Ecommerce + BTCPay plugins CLightning Lightning Charge LIBRE PATRON QUICKBOOK PLUGIN
- 29.
- 30. How is docker-compose.generated.yml running?(btcpay-up.sh) .env file Btcpay-up.sh Btcpay- down.sh Docker-compose up Docker-compose down Docker- compose.gene rated.yml
- 31.
- 32. What are thosedocker fragments? Docker fragments Docker imagesEnvironment variables in .env file Docker-Hub Docker- Compose- Generator
- 33. What are thosedocker fragments? 1. Standard docker-compose files 2. All selected fragments are merged together by the docker- compose-generator 3. A fragment can modify any container configuration A new container contains “image:” No “image:” are modifications to an existing container
- 34. Tons of themexists And you can create custom fragments!
- 35. Which docker images? …worstcase: around 37 projects maintained by different people All dependency sources are documented in README.md (Github + DockerHub links)
- 36. As maintainer, howdo I update an image? Update the fragment, and git push. VOILA!
- 37. As a user,how do I update? Run btcpay-update.sh! Btcpay- update.sh Git pull Docker- compose up Docker- Compose- Generator SSH
- 38. No auto update,because: 1. If it is not broken, don’t update it 2. Would introduce a systemic risk for BTCPay Server 3. Would incentivize hackers to push malicious update 4. I don’t want a sudden flood of thousand of angry merchants banging to my door
- 39.
- 40. Tooling and Nginxconfiguration Docker fragments Shitcoins Third party plugins WoocommerceLibrepatron Quickbook plugin Extensibility Tooling Bitcoin-cli.sh ... Production/nginx.tmpl
- 41. Tooling helpers.sh Btcpay-update.sh Btcpay-setup.sh If <container_name>exists then put <script_name>.sh in /usr/bin
- 42. Nginx configuration 1. Definerules decide to which container to forward incoming HTTP/S request 2. Can use decide based on path or domain name
- 43. Extensibility Production/nginx.tmpl Forward based onpath Forward based on domain
- 44. Production/nginx.tmpl Generated/nginx.tmpl Copied by btcpay-update.sh/btcpay-setup.sh Generatedby nginx-gen container default.conf Can see the default.conf with: docker exec nginx cat /etc/nginx/conf.d /default.conf
- 45. Path based routing Ifit is librepatrons’ domain… Nginx.tmpl Opt-add-librepatron.yml
- 46. Path based routing Andthat the pass is /isso: Forward to port 8080 of isso container Nginx.tmpl
- 47.
- 48.
- 49. Image creation process Docker-Hub.circleci/config.yml Git push --tags Multi Arch Manifest Images ARM32v7 AMD64 Image s github repo Qemu or Cross compile Raspberry PI
- 50. Existing images Support RaspberryPI No Raspberry PI
- 51. Docker Hub https://hub.docker.com/r/btcpayserver/bitcoin/tags Multi Archimage Architecture specific image
- 52. New image releasetypical workflow: 1. Git tag –a v1.2.3 –m v1.2.3 2. Git push –tags 3. Drink tea 4. Double check that it has been created on DockerHub
- 53. .circleci/config.yml: Build andpublish amd64 img
- 54. .circleci/config.yml: Build andpublish arm32v7 img
- 55. .circleci/config.yml: Build andpublish manifest img
- 57. btcpayserver-docker Btcpay- setup.sh Docker- Compose- Generator Docker fragments BTCPAYGEN_ environment variables .env file Btcpay-up.sh Btcpay- down.sh Docker- compose.gene rated.yml Docker images Shitcoins Thirdparty plugins WoocommerceLibrepatron Quickbook plugin Btcpay- update.sh Git pull Docker- compose up Docker-compose up Docker-compose down Extensibility Tooling Bitcoin-cli.sh ... Production/nginx.tmpl Docker- compose.gene rated.yml Environment variables in .env fileTOOLING SCRIPTS SETUP INFORMATION A boring bubble Docker-Hub .circleci/config.yml Git push --tags Multi Arch Manifest Images ARM32v7 AMD64 Image s github repo Qemu or Cross compile Raspberry PI Build.sh Docker- Compose- Generator Forward based on path Forward based on domain
- 58.
- 59.
- 60.
- 61.