![\"-\"](\"https:\/\/upcloud.com\/media\/buddy-logo-blue-1-7.png\"){kind=logo}
<\/a><\/figure>\n<\/div>\n\n\nAutomate builds and deployments with 70+ ready-to-use actions on Buddy. Pick from a large number of easy-to-use deployment integrations including support for containers on Docker and Kubernetes.<\/p>\n\n\n\n
In this guide, we\u2019ll be checking some of the neat features of Buddy and how to integrate it with your UpCloud servers. Follow along to get started with Buddy, create your first deployment pipeline and see it work in practice.<\/p>\n\n\n\n
1. Signing up with UpCloud<\/h2>\n\n\n\n
Firstly, if you have not yet registered on UpCloud, you should begin by getting signed up<\/a>. You can follow this guide perfectly while on a trial account.<\/p>\n\n\n\n The link opens in a new window \u2013 we\u2019ll wait here for you!<\/p>\n\n\n\n To allow Buddy to access to your UpCloud account through our API, you first need to set up API permissions. We recommend creating a new workspace member account specifically for API usage with its own username and password for each external service you might use. This allows you to limit API access and specify permissions for increased security.<\/p>\n\n\n\n You can find detailed instructions on how to create API credentials in our beginners’ guide for UpCloud API<\/a>.<\/p>\n\n\n\n Once you have a workspace member account for Buddy API access continue ahead to their platform.<\/p>\n\n\n\n Next, if you haven\u2019t yet, sign up with Buddy<\/a> or log in using your GitHub, Bitbucket or Google account.<\/p>\n\n\n\n Once registered, log in and head to your dashboard<\/a>.<\/p>\n\n\n\n Buddy will create you the first workspace for free.<\/p>\n\n\n\n On Buddy, each web site and application is contained within a project. You can have a number of projects at any one time, but for now, you only need one.<\/p>\n\n\n\n To get started, click the button to Create new project<\/strong>.<\/p>\n\n\n\n Buddy can integrate with the most popular code repositories. For this guide, we\u2019ll be checking out Buddy Git Hosting<\/strong>.<\/p>\n\n\n\n Give the new project a name and click Create a new project<\/strong> button to confirm.<\/p>\n\n\n\n Once you\u2019ve created the first project, your repository is ready and waiting!<\/p>\n\n\n\n With the project space created, continue on with rest of the guide.<\/p>\n\n\n\n Besides API access, Buddy also needs to be able to authenticate onto your cloud server. Before you can get deploying, you should look up your Buddy SSH key and add it to your UpCloud account.<\/p>\n\n\n\n Each project on Buddy has it\u2019s own SSH key pair that allows password-free authentication for automation processes. Find your Buddy public SSH key in the Project Options<\/strong> by clicking the link at the navigation bar.<\/p>\n\n\n\n In the project settings, you have a number of options like inviting others to your project team, adding and editing project variables, as well as other project-specific options such as renaming the project.<\/p>\n\n\n\n Click the link Buddy Public Key<\/strong> on the right side of the settings panel to show your SSH key.<\/p>\n\n\n\n Copy the key part coloured green without the single quotation marks onto your clipboard or download the public key.<\/p>\n\n\n\n The key part will look like the example below.<\/p>\n\n\n\n Once you\u2019ve found your Buddy SSH key, head over to your UpCloud control panel and SSH keys under account settings<\/a>. Click the Add new<\/strong> button.<\/p>\n\n\n\n Then paste your Buddy public key into the SSH key field, rename the key as you like, then click the button to Save the SSH key<\/strong>.<\/p>\n\n\n\n After saving the Buddy public key, continue on with deploying a new cloud server.<\/p>\n\n\n\n Next, you\u2019ll need somewhere for your future projects to live on. Cloud servers are perfect for experimenting with new app ideas due to how quick and easy it is to create a pristine host on a moments notice.<\/p>\n\n\n\n Deploy a new cloud server<\/a> to host your project. Firstly, make the following configurations.<\/p>\n\n\n\n With the server configured, include the Buddy SSH key<\/strong> you saved earlier by clicking the key name to select it. Each public SSH key saved on your account can be added onto a server at deployment and will allow easy and secure authentication to the host.<\/p>\n\n\n\n The Buddy SSH keys are project specific and only used by actions within that one project. For any other projects, make sure to add the corresponding public key to your cloud servers.<\/p>\n\n\n\n Then before deploying the new server, include the following<\/strong> initialization script in the text field.<\/p>\n\n\n\n The initialization scrips are programmable command sets that allow you to automate many of the initial configuration tasks required on newly deployed servers. The script in this example will update your server to the latest software patches and installs a web hosting service which we\u2019ll need later.<\/p>\n\n\n\n Once all set, click the Deploy<\/strong> button at the end of the configuration page to launch the server.<\/p>\n\n\n\n Lastly, you\u2019ll need to give your Buddy API account permission to access the new server. Go to your workspace members list<\/a> and open the API account settings by clicking the API account name<\/strong>.<\/p>\n\n\n\n In the API account settings, click the button to Select servers<\/strong> then pick the host you just deployed. Finally, click the Save<\/strong> button on the pop-up window and the Save changes<\/strong> button near the bottom of the page.<\/p>\n\n\n\n That\u2019s the last of the prerequisite steps to get started with Buddy, continue below to begin developing your project.<\/p>\n\n\n\n Buddy offers a useful online code editor that makes writing small programs and configuration files a breeze. Go to your project page again and click the New file<\/strong> button to start a new file in the editor.<\/p>\n\n\n\n Next, we\u2019ll create a simple HTML file to test the deployment system. Name the file index.html<\/tt> and include the following code snippet in the editor window.<\/p>\n\n\n\n The editor includes a syntax highlight features that automatically adjust to the file type according to the file extension in the name field.<\/p>\n\n\n\n Once ready, click the Commit button at the bottom of the editor to save the file to your repository.<\/p>\n\n\n\n Now that you have the first page ready to go, you\u2019ll need to set up a deployment process to get the file onto your cloud server. Continue with the guide below on how to configure a new pipeline.<\/p>\n\n\n\n Pipelines on Buddy are extensively configurable automation processes that allow you to quickly and easily deploy changes in your code. Start the setup by going to the Pipelines tab at your project page and click the Add a new pipeline<\/strong> button.<\/p>\n\n\n\n In the new pipeline configuration, give the deployment method a name and select the On push<\/em> trigger mode. Then click the Add a new pipeline<\/strong> button to continue.<\/p>\n\n\n\n Next, you\u2019ll need to add a new action to the pipeline. Buddy supports a whole host of different methods for deploying your project. Find the UpCloud infrastructure-as-a-service option by using the search field, then click the UpCloud integration icon.<\/p>\n\n\n\n Since this is likely the first time you are adding integration with UpCloud on Buddy, you\u2019ll need to configure API access.<\/p>\n\n\n\n Give the integration a name as you like. Next, enter your UpCloud API account name and password that you set up earlier in the 2. section of this guide. Then save the credentials by clicking the button to Add integration<\/strong>.<\/p>\n\n\n\n Once you\u2019ve set up the integration between Buddy and UpCloud, you\u2019ll have the option to configure automated file transfers onto UpCloud servers along with many other actions.<\/p>\n\n\n\n In the file transfer settings, select the Buddy\u2019s SSH key as Authentication mode<\/em> and enter the following directory as the Remote path<\/em>.<\/p>\n\n\n\n Buddy will query your UpCloud account using the API access to find the server you deployed and granted permissions for. While you have only one cloud server accessible to Buddy it will be selected automatically. If you want to use an existing cloud server, make sure to add the Buddy SSH key to your authorized keys file and give your API account permissions to the server.<\/p>\n\n\n\n Confirm the selections by clicking the Add this action<\/strong> button at the bottom of the window.<\/p>\n\n\n\n Creating actions in your pipeline forms a queue of operations that are executed when the pipeline is run. Once configured, actions in the pipeline can be toggled on and off as well as re-ordered just by drag and drop.<\/p>\n\n\n\n That\u2019s it for the setup and configurations. Next up comes the amazing bit that all the work up till now has been for!<\/p>\n\n\n\n Next up comes the best bit, seeing all of the steps come together with nice results! The whole point of pipelines is getting your project files deployed in an orderly fashion and Buddy accomplishes this without a fuss.<\/p>\n\n\n\n Now, test your setup by clicking the Run pipeline<\/strong> button.<\/p>\n\n\n\n In the confirmation window, add a comment about the action and then click the Run now<\/strong> button.<\/p>\n\n\n\n A simple operation of a single file transfer is almost instant, but with longer deployment processes you can follow the progress at the pipeline view.<\/p>\n\n\n\n Once completed, open the public IP of your cloud server in a web browser to see the results. You can find the IP address at your UpCloud control panel<\/a> on the servers list.<\/p>\n\n\n\n You should see the example landing page with the traditional message as above.<\/p>\n\n\n\n But that is not all! Next, test the On push<\/em> trigger of the pipeline by making a small but observable change in the index.html<\/tt> file.<\/p>\n\n\n\n Go back to the Code page in your project and open the file for edit by clicking the file name. Add the following short paragraph after the first message and click the Commit<\/strong> button.<\/p>\n\n\n\n Once you hit commit, Buddy will automatically run the configured pipeline deploying the changes to your server. You can see the pipeline execution history on the Pipelines<\/em> page under Executions<\/em>.<\/p>\n\n\n\n Then refresh the web page at your server\u2019s IP address to see the changes.<\/p>\n\n\n\n The update to the index file was immediately pushed to the server and visible right away!<\/p>\n\n\n\n Congratulations! You\u2019ve now successfully configured an integration between Buddy and UpCloud along with a cloud server and the first pipeline onto it. However, this is just the start, there\u2019s a lot more you can automate on Buddy.<\/p>\n\n\n\n Now that you know the basics, feel free to play around with the pipeline settings to get familiar with Buddy\u2019s features and add new actions. You can learn more about pipelines and other ways to use Buddy at their documentation page<\/a>.<\/p>\n","protected":false},"author":3,"featured_media":27405,"comment_status":"open","ping_status":"closed","template":"","community-category":[256,223],"class_list":["post-2248","tutorial","type-tutorial","status-publish","has-post-thumbnail","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/tutorial\/2248","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/tutorial"}],"about":[{"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/types\/tutorial"}],"author":[{"embeddable":true,"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/comments?post=2248"}],"version-history":[{"count":0,"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/tutorial\/2248\/revisions"}],"wp:attachment":[{"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/media?parent=2248"}],"wp:term":[{"taxonomy":"community-category","embeddable":true,"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/community-category?post=2248"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}2. Configuring UpCloud API access<\/h2>\n\n\n\n
3. Registering with Buddy<\/h2>\n\n\n\n
![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-workspace-7.png\")
<\/figure>\n\n\n\n4. Starting your first project<\/h2>\n\n\n\n
![\"-\"](\"https:\/\/upcloud.com\/media\/buddy-dashboard-7.png\")
<\/figure>\n\n\n\n![\"-\"](\"https:\/\/upcloud.com\/media\/buddy-new-project-e1547118122156-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-new-repository-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-repository-ready-7.png\")
<\/figure>\n\n\n\n5. Configuring your Buddy SSH key<\/h2>\n\n\n\n
![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-project-options-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-project-options2-7.png\")
<\/figure>\n\n\n\nssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCX2UnF6Ae\/rzT7hxNYNQgXJX4GGaXxVx2N6PB5zlPk+9syroF2Io61gOsEGj6L\/PmEdNdL\/3mlapWbOjGm2fnzq\/Np15vJahoSs8YmptcNM8vRhDluAKLV\/OoOu+n5annjgMoGxXGfGfIWZfDxBCWn+Fdl9hEwm3fFZnr\/Ja7ZcPbIvpJzvWNdDqyYo3NXG207efS5wWRDJgPP4AGbS656DjVgr94lQcDLnuYSZzBvkyEMHjK87ncfrF720C6aKpycC1a9cyRVax0CemHgFpISluTssNyf+EAlwe99zmLGMaBRYskPQlagoEjXY5c9Yw\/OhLoAE+kHpW0uxh8qvHLf the-great-cloud Key<\/pre>\n\n\n\n
![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-project-public-key-7.png\")
<\/figure>\n\n\n\n![\"Upcloud](\"https:\/\/upcloud.com\/media\/upcloud-ssh-keys.png\")
<\/figure>\n\n\n\n![\"Upcloud](\"https:\/\/upcloud.com\/media\/upcloud-add-ssh-key-7.png\")
<\/figure>\n\n\n\n6. Deploying a cloud server<\/h2>\n\n\n\n
\n
apt-get update && apt-get upgrade -y\napt-get install nginx -y<\/pre>\n\n\n\n
![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-deploy-new-server-nginx-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-api-account-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-add-permissions-7.png\")
<\/figure>\n\n\n\n7. Committing your first file<\/h2>\n\n\n\n
![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-new-file-7.png\")
<\/figure>\n\n\n\n<!DOCTYPE html>\n<html>\n<body style=\"width: 30em; margin: 0 auto;\">\n<h1>Hello World!<\/h1>\n<\/body>\n<\/html><\/pre>\n\n\n\n
![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-hello-world-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-first-commit-7.png\")
<\/figure>\n\n\n\n8. Configuring the deployment pipeline<\/h2>\n\n\n\n
![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-create-new-pipeline-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-new-pipeline-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-action-upcloud-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-upcloud-integration-7.png\")
<\/figure>\n\n\n\n\/var\/www\/html<\/pre>\n\n\n\n
![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-transfer-files-upcloud-1-7.png\")
<\/figure>\n\n\n\n9. Testing the pipeline<\/h2>\n\n\n\n
![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-upcloud-pipeline-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-run-pipeline-now-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-hello-world-live-e1547480730546-7.png\")
<\/figure>\n\n\n\n<!DOCTYPE html>\n<html>\n<body style=\"width: 30em; margin: 0 auto;\">\n<h1>Hello World!<\/h1>\n<p>Every commit automatically deployed<\/p>\n<\/body>\n<\/html><\/pre>\n\n\n\n
![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-hello-world-update-7.png\")
<\/figure>\n\n\n\n![\"-\"](\"https:\/\/upcloud.com\/media\/buddy-commit-history-7.png\")
<\/figure>\n\n\n\n![\"Buddy](\"https:\/\/upcloud.com\/media\/buddy-hello-world-live-update-e1547480758444-7.png\")
<\/figure>\n\n\n\nDone!<\/h2>\n\n\n\n