diff options
author | Christian Oliff <christianoliff@pm.me> | 2022-04-18 18:34:15 +0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-04-18 18:34:15 +0300 |
commit | e254724a756494de68ebe8e99f0a5e87c5cf05c0 (patch) | |
tree | 9c0445cb7444ed5b2ff96f9c8836e0339061cd7a | |
parent | f4304fb7e5a5bbce4e4c0587d609b00296a34500 (diff) |
Delete hosting-on-bitbucket.md (#1723)
This article depends on https://www.aerobatic.com/ which is no longer online. Let's delete this page.
-rw-r--r-- | content/en/hosting-and-deployment/hosting-on-bitbucket.md | 141 |
1 files changed, 0 insertions, 141 deletions
diff --git a/content/en/hosting-and-deployment/hosting-on-bitbucket.md b/content/en/hosting-and-deployment/hosting-on-bitbucket.md deleted file mode 100644 index 9ab926751..000000000 --- a/content/en/hosting-and-deployment/hosting-on-bitbucket.md +++ /dev/null @@ -1,141 +0,0 @@ ---- -title: Host on Bitbucket -linktitle: Host on Bitbucket -description: You can use Bitbucket in conjunction with Aerobatic to build, deploy, and host a Hugo website. -date: 2017-02-04 -publishdate: 2017-02-04 -lastmod: 2017-02-04 -categories: [hosting and deployment] -keywords: [hosting,bitbucket,deployment,aerobatic] -authors: [Jason Gowans] -menu: - docs: - parent: "hosting-and-deployment" - weight: 50 -weight: 50 -sections_weight: 50 -draft: false -toc: true -aliases: [/tutorials/hosting-on-bitbucket/] ---- - -You can use [Bitbucket](https://bitbucket.org/) and [Aerobatic](https://www.aerobatic.com) to build, deploy, and host a Hugo website. Aerobatic is a static hosting service that integrates with Bitbucket and provides a free hosting tier. - -## Assumptions - -* Working familiarity with Git for version control -* A [Bitbucket account](https://bitbucket.org/account/signup/) - -## Install Aerobatic CLI - -If you haven't previously used Aerobatic, you'll first need to install the Command Line Interface (CLI) and create an account. For a list of all commands available, see the [Aerobatic CLI](https://www.aerobatic.com/docs/cli/) docs. - -``` -npm install aerobatic-cli -g -aero register -``` - -## Create and Deploy Site - -``` -hugo new site my-new-hugo-site -cd my-new-hugo-site -cd themes; git clone https://github.com/eliasson/liquorice -hugo -t liquorice -aero create # create the Aerobatic site -hugo --baseURL https://my-new-hugo-site.aerobatic.io # build the site overriding baseURL -aero deploy -d public # deploy output to Aerobatic - -Version v1 deployment complete. -View now at https://hugo-docs-test.aerobatic.io -``` - -In the rendered page response, the `https://__baseurl__` will be replaced with your actual site url (in this example, `https://my-new-hugo-site.aerobatic.io`). You can always rename your Aerobatic website with the `aero rename` command. - -## Push Hugo site to Bitbucket - -We will now create a git repository and then push our code to Bitbucket. In Bitbucket, create a repository. - -![Bitbucket Screenshot][1] - -[1]: /images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-create-repo.png - -``` -# initialize new git repository -git init - -# set up our .gitignore file -echo -e "/public \n/themes \naero-deploy.tar.gz" >> .gitignore - -# commit and push code to master branch -git add --all -git commit -m "Initial commit" -git remote add origin git@bitbucket.org:YourUsername/my-new-hugo-site.git -git push -u origin master -``` - -## Continuous Deployment With Bitbucket Pipelines - -In the example above, we pushed the compiled assets in the `/public` folder to Aerobatic. In the following example, we use Bitbucket Pipelines to continuously create and deploy the compiled assets to Aerobatic. - -### Step 1: Configure Bitbucket Pipelines - -In your Hugo website's Bitbucket repo; - -1. Click the Pipelines link in the left nav menu of your Bitbucket repository. -2. Click the Enable Pipelines button. -3. On the next screen, leave the default template and click Next. -4. In the editor, paste in the yaml contents below and click Commit. - -``` -image: beevelop/nodejs-python -pipelines: - branches: - master: - - step: - script: - - apt-get update -y && apt-get install wget - - apt-get -y install git - - wget https://github.com/gohugoio/hugo/releases/download/v0.18/hugo_0.18-64bit.deb - - dpkg -i hugo*.deb - - git clone https://github.com/eliasson/liquorice themes/liquorice - - hugo --theme=liquorice --baseURL https://__baseurl__ --buildDrafts - - npm install -g aerobatic-cli - - aero deploy -``` - -### Step 2: Create `AEROBATIC_API_KEY` environment variable. - -This step only needs to be done once per account. From the command line; - -``` -aero apikey -``` - -1. Navigate to the Bitbucket account settings for the account that the website repo belongs to. -2. Scroll down to the bottom of the left nav and click the Environment variables link in the PIPELINES section. -3. Create a new environment variable called AEROBATIC_API_KEY with the value you got by running the `aero apikey` command. Be sure to click the Secured checkbox. - -### Step 3: Edit and Commit Code - -``` -hugo new posts/good-to-great.md -hugo server --buildDrafts -t liquorice #Check that all looks good - -# commit and push code to master branch -git add --all -git commit -m "New blog post" -git push -u origin master -``` - -Your code will be committed to Bitbucket, Bitbucket Pipelines will run your build, and a new version of your site will be deployed to Aerobatic. - -At this point, you can now create and edit blog posts directly in the Bitbucket UI. - -![Bitbucket blog Screenshot][2] - -[2]: /images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-blog-post.png - -## Suggested next steps - -The code for this example can be found in this Bitbucket [repository](https://bitbucket.org/dundonian/hugo-docs-test). Aerobatic also provides a number of additional [plugins](https://www.aerobatic.com/docs) such as auth and redirects that you can use for your Hugo site. |