Shippable 3.0 Breaking Changes

- By Lekha Bhargavi

BACK TO BLOG HOME

 

Recently, we announced significant enhancements to Shippable CI/CD, including a completely redesigned user experience and the ability to use custom images without the need for dedicated hosts. As a result of these announcements, we will be deprecating certain functionality as it exists in its current form on July 30th.

Details on the changes are as follows. Please note that each of the changes below will require action on your part to convert to the new method.

Existing functionality to be deprecated New method

build_image: Users could specify their base image to use for the build within the yml file.

 

Specifying the build_image has moved to the Project Settings page. Going forward, the shippable.yml file will only contain user-specific actions related to the build process.

Click for more details.

commit_container:  Users used the commit_container tag in their YML to push an image to the Docker registry.

Use the Push Build option under Project Settings to specify whether an image needs to be pushed to the registry.

Click for more details.

cache: Caching was enabled by using cache:true option in shippable YML.

Use the Cache Container option under Project Settings to specify whether caching needs to be turned on. 

Click for more details.

Entering Docker credentials: Users entered their Docker credentials for Docker Hub through a dialog box accessed via the "Docker Hub" icon on the Project Dashboard page.

In the new UI, all external integrations, including specifying Docker Credentials, will take place on the Account Integrations page.

Click for more details.

 

1. Configuration moving from YML to Project Settings

Project specific settings are now available under Settings in your project page. To get here, login to Shippable, navigate to the project page and click on the Settings tab.

build_image: To specify a build image, enter the appropriate image under Pull Image from option under Project Settings. Example: shippableimages/ubuntu1204_python. Check out our documentation for more info. 

commit_container: Instead of commit_container in the YML, choose whether you would like to push build by using the toggle button against the Push Build option under Project Settings. Check out our documentation for more info. 

cache: Use the Cache Container option under Project Settings to specify whether you want caching turned on for your build. Check out our documentation for more info. 

 

project_settings 

 

2. Docker Credentials

Previously, users entered their Docker credentials for Docker Hub through a dialog box accessed via the "Docker Hub" icon on the Project Dashboard page.

In the new UI, all external integrations, including specifying Docker Credentials, takes place on the Account Settings page. 

- Click on Account Settings on the top nav bar 

account_settings
- Click  + to add a new Account Integration
 
add_integration-1
 
- Select Docker as the Master Integration and enter your Docker Credentials
 new_docker_int-1
You can also review our documentation on how to add an integration for Docker Hub  to convert your existing settings.

 

We're confident that these changes will improve your user experience with Shippable. Please feel free to reach out with any feedback or questions.

Topics: continuous deployment (CD), continuous integration (CI)