diff --git a/ieeeSW/releaseEng3/IEEE_ThemeIssue_ReleaseEng_CD.md b/ieeeSW/releaseEng3/IEEE_ThemeIssue_ReleaseEng_CD.md index e8f0240..324a7ca 100644 --- a/ieeeSW/releaseEng3/IEEE_ThemeIssue_ReleaseEng_CD.md +++ b/ieeeSW/releaseEng3/IEEE_ThemeIssue_ReleaseEng_CD.md @@ -11,19 +11,42 @@ geometry: "left=1in,right=1.5in" ## Authors -__Rodrigo Siqueira__ is a masters student at IME - The Institute of Mathematics and Statistics of the Sao Paulo University. His research interests include software engineering, operating system and computer architecture. He worked for two years with the Brazilian federal government as a coach and developer. Contact him at siqueira@ime.usp.br. - -__Diego Camarinha__ is a masters student at IME - The Institute of Mathematics and Statistics of the Sao Paulo University. His research interests include software engineering, computer networks and source code metrics. He worked for two years with the Brazilian federal government as a senior developer. Contact him at diegoamc@ime.usp.br. - -__Melissa Wen__ is a software developer. She worked on SPB project as a senior developer and also served as professor of Computer Science at UFBA - The Federal University of Bahia. Her areas of interest include software engineering and open source software development. Contact her at melissa.srw@gmail.com . - -__Paulo Meirelles__ received his Ph.D. in Computer Science from the Institute of Mathematics and Statistics at the University of São Paulo. He is full-time Professor at the University of Brasilia, and coordinated the new SPB Portal project. His research interest areas are: Free Software, Agile methods, Static analysis, and Source code metrics. Contact him at paulormm@ime.usp.br. - -__Fabio Kon__ is Full Professor of the Department of Computer Science of the University of São Paulo. (...) .His research interest areas are: (...). Contact him at fabio.kon@ime.usp.br. +__Rodrigo Siqueira__ is a masters student at IME - The Institute of Mathematics +and Statistics of the Sao Paulo University. His research interests include +software engineering, operating system and computer architecture. He worked for +two years with the Brazilian federal government as a coach and developer. +Contact him at siqueira@ime.usp.br. + +__Diego Camarinha__ is a masters student at IME - The Institute of Mathematics +and Statistics of the Sao Paulo University. His research interests include +software engineering, computer networks and source code metrics. He worked for +two years with the Brazilian federal government as a senior developer. Contact +him at diegoamc@ime.usp.br. + +__Melissa Wen__ is a software developer. She worked on SPB project as a senior +developer and also served as professor of Computer Science at UFBA - The Federal +University of Bahia. Her areas of interest include software engineering and open +source software development. Contact her at melissa.srw@gmail.com . + +__Paulo Meirelles__ received his Ph.D. in Computer Science from the Institute of +Mathematics and Statistics at the University of São Paulo. He is full-time +Professor at the University of Brasilia, and coordinated the new SPB Portal +project. His research interest areas are: Free Software, Agile methods, Static +analysis, and Source code metrics. Contact him at paulormm@ime.usp.br. + +__Fabio Kon__ is Full Professor of the Department of Computer Science of the +University of São Paulo. (...) .His research interest areas are: (...). Contact +him at fabio.kon@ime.usp.br. ## Abstract -For many software development teams, the first aspects that come to mind regarding Continuous Delivery (CD) are the operational challenges and the competitive benefits. In our experience, the CD was much more: it was a survival technique. This article presents how and why we applied CD in a Brazilian government project for the development of a Collaborative Development Environment (CDE), sharing the challenges we faced and the strategies used to overcome them. +For many software development teams, the first aspects that come to mind +regarding Continuous Delivery (CD) are the operational challenges and the +competitive benefits. In our experience, the CD was much more: it was a survival +technique. This article presents how and why we applied CD in a Brazilian +government project for the development of a Collaborative Development +Environment (CDE), sharing the challenges we faced and the strategies used to +overcome them. ## Introduction -We worked on a three-year-long Brazilian government project to evolve an existing platform that had technical issues and lacked political support. This project, started in 2014, was a partnership between the Ministry of Planning, Budget, and Management (MP) and two public universities: University of Brasília (UnB) and University of São Paulo (USP), to modernize Brazilian Public Software (SPB) portal. - -With this partnership, the SPB Portal (www.softwarepublico.gov.br) evolved to a Collaborative Development Environment[1], and this evolution brought significant benefits not just to the Brazilian government, but also to society as a whole. The government could minimize bureaucracy and costs of software development, encouraging the use of the same set of applications across different government agencies. The society also gained a mechanism of transparency and collaboration, since anyone can check the government expenses on software and contribute to project communities. - -In this article, we discuss the use of Continuous Delivery (CD) during our experience as the academic partner in this project. We focus on how we managed to implement CD in a large institution with traditional values and how CD helped to build trust between the government and the university development team. CD enabled us to show our progress and earned the government’s confidence that we could adequately fulfill their requests, becoming an essential aspect of our interaction with them. According to this experience, the use of CD as a tool to build such trust relationships is yet another of its benefits[2]. +We worked on a three-year-long Brazilian government project to evolve an +existing platform that had technical issues and lacked political support. +This project, started in 2014, was a partnership between the Ministry of +Planning, Budget, and Management (MP) and two public universities: +University of Brasília (UnB) and University of São Paulo (USP), to +modernize Brazilian Public Software (SPB) portal. + +With this partnership, the SPB Portal (www.softwarepublico.gov.br) evolved to a +Collaborative Development Environment[1], and this evolution brought significant +benefits not just to the Brazilian government, but also to society as a whole. +The government could minimize bureaucracy and costs of software development, +encouraging the use of the same set of applications across different government +agencies. The society also gained a mechanism of transparency and collaboration, +since anyone can check the government expenses on software and contribute to +project communities. + +In this article, we discuss the use of Continuous Delivery (CD) during our +experience as the academic partner in this project. We focus on how we managed +to implement CD in a large institution with traditional values and how CD helped +to build trust between the government and the university development team. CD +enabled us to show our progress and earned the government’s confidence that we +could adequately fulfill their requests, becoming an essential aspect of our +interaction with them. According to this experience, the use of CD as a tool to +build such trust relationships is yet another of its benefits[2]. ## Context -The SPB is a governmental program of the MP created to foster sharing and collaboration on Open Source Software (OSS) development for the Brazilian public administration. For their projects, the MP managed both software requirements and server infrastructure. However, its hierarchical and traditional processes made them unfamiliar with new software development techniques, such as CD. Any of our requests had to pass through layers of bureaucracy before being answered. Requesting access to their infrastructure to make the deploy was not different. - -During its lifetime, the project suffered significant interference from the board of directors because the portal represents an interface between government and society. In light of political interests, directors continually imposed changes to the platform while ignoring our technical advice. In 2015, the board of directors was changed and, with it, the vision of the project. New directors had different political agendas which affected the project's requirements previously approved. +The SPB is a governmental program of the MP created to foster sharing and +collaboration on Open Source Software (OSS) development for the Brazilian public +administration. For their projects, the MP managed both software requirements +and server infrastructure. However, its hierarchical and traditional processes +made them unfamiliar with new software development techniques, such as CD. Any +of our requests had to pass through layers of bureaucracy before being answered. +Requesting access to their infrastructure to make the deploy was not different. + +During its lifetime, the project suffered significant interference from the +board of directors because the portal represents an interface between government +and society. In light of political interests, directors continually imposed +changes to the platform while ignoring our technical advice. In 2015, the board +of directors was changed and, with it, the vision of the project. New directors +had different political agendas which affected the project's requirements +previously approved. -In this context, we overcame three distinct challenges: (1) find a system solution wherein government and development team agree, (2) deconstruct the widespread belief among the government agents that any project in partnership with a University is doomed to fail, and (3) deal with bureaucracies involved in the deployment process by the MP. +In this context, we overcame three distinct challenges: (1) find a system +solution wherein government and development team agree, (2) deconstruct the +widespread belief among the government agents that any project in partnership +with a University is doomed to fail, and (3) deal with bureaucracies involved in +the deployment process by the MP. -Firstly, to find a system solution wherein government and development team agree, we designed the SPB Portal as a CDE with additional social features. Due to the complexity of creating such a system from scratch, we decided to adapt and integrate existing open source tools to build a system-of-systems [3]. We created a solution that orchestrates software and allowed us to smoothly provide a unified interface for final users, including single sign-on and global searches [4]. On top of that, the new SPB Portal was an unprecedented platform to the Brazilian government, with a complicated deployment process. +Firstly, to find a system solution wherein government and development team +agree, we designed the SPB Portal as a CDE with additional social features. Due +to the complexity of creating such a system from scratch, we decided to adapt +and integrate existing open source tools to build a system-of-systems [3]. We +created a solution that orchestrates software and allowed us to smoothly provide +a unified interface for final users, including single sign-on and global +searches [4]. On top of that, the new SPB Portal was an unprecedented platform +to the Brazilian government, with a complicated deployment process. -Secondly, we had to face the widespread belief among government agents that any project in partnership with a University is doomed to fail. Our team was not from a typical company, consisting mainly of undergraduate students coordinated by two professors. At the first year, we had a group composed of 24 undergraduate students, one designer, and two senior developers. In 2015, our team grew to 36 students, two designers, eight senior developers. At the end of in project, due to budget constraint, we had 20 students, one designer, and two developers. Also, on the government side, the SPB Portal evolution was the first software development collaboration between university and government experienced by the MP analysts involved in the project. +Secondly, we had to face the widespread belief among government agents that any +project in partnership with a University is doomed to fail. Our team was not +from a typical company, consisting mainly of undergraduate students coordinated +by two professors. At the first year, we had a group composed of 24 +undergraduate students, one designer, and two senior developers. In 2015, our +team grew to 36 students, two designers, eight senior developers. At the end of +in project, due to budget constraint, we had 20 students, one designer, and two +developers. Also, on the government side, the SPB Portal evolution was the first +software development collaboration between university and government experienced +by the MP analysts involved in the project. -Lastly, our team thought software deployment differently than the MP. On our side, we believe that frequent deliveries are better for the project’s success. However, the MP works with the idea of a single deployment at the end of the project. In other words, neither the bureaucratic structure of the MP nor its technical abilities were conducive to this style of work. Furthermore, there was little effort to deploy new versions of the system promptly. That ended up hampering the benefits of the tool and preventing us from showing off the fruits of the project to those responsible for evaluating it. +Lastly, our team thought software deployment differently than the MP. On our +side, we believe that frequent deliveries are better for the project’s success. +However, the MP works with the idea of a single deployment at the end of the +project. In other words, neither the bureaucratic structure of the MP nor its +technical abilities were conducive to this style of work. Furthermore, there was +little effort to deploy new versions of the system promptly. That ended up +hampering the benefits of the tool and preventing us from showing off the fruits +of the project to those responsible for evaluating it. -These challenges made our relationship with the MP tense, in particular at the first year, and alerted us to the fact that they could finish the project at any time. The deployment limitation was the substantial technical issue we could tackle in the short term. As a result, we worked to deploy one version of the project onto our infrastructure and showed it to the government evaluators. This strategy proved them we could efficiently deliver new features, fulfill their expectations regarding the delivery of the requirements, and incited them to demand the last version working in the MP infrastructure. These results, in turn, generated more pressure on the IT department responsible for the deployment routines. With each CD cycle, we gradually built a new relationship among all parties and, by the end of the project, we became active participants in the deploy operations. +These challenges made our relationship with the MP tense, in particular at the +first year, and alerted us to the fact that they could finish the project at any +time. The deployment limitation was the substantial technical issue we could +tackle in the short term. As a result, we worked to deploy one version of the +project onto our infrastructure and showed it to the government evaluators. This +strategy proved them we could efficiently deliver new features, fulfill their +expectations regarding the delivery of the requirements, and incited them to +demand the last version working in the MP infrastructure. These results, in turn, +generated more pressure on the IT department responsible for the deployment +routines. With each CD cycle, we gradually built a new relationship among all +parties and, by the end of the project, we became active participants in the +deploy operations. ## Our Continuous Delivery Pipeline @@ -169,7 +261,7 @@ five reasons: * Packaging allows configurations and permissions control. After creating a new tag for one component, the developers informed the DevOps -[3] team, and the packaging process began. A set of scripts fully automated the +[5] team, and the packaging process began. A set of scripts fully automated the three packaging steps aforementioned. With all them running successfully, the new packages would be ready to be used by our deployment scripts. @@ -206,7 +298,7 @@ users. ## Benefits -Research points out many advantages of CD usage in the industry[2, 5], such as +Research points out many advantages of CD usage in the industry[2, 6], such as accelerated time to market, building the right product, productivity and efficiency improvements, stable releases, and better customer satisfaction. Working with the government, we noticed the following additional benefits. @@ -355,10 +447,12 @@ We thank our colleagues, Nelson Lago, Lucas Kanashiro and Rafael Manzo, and this 3. ISO/IEC/IEEE International Standard - Systems and software engineering -- System life cycle processes," in ISO/IEC/IEEE 15288 First edition 2015-05-15, 2015, pp.1-118. 4. Meirelles, P., Wen, M., Terceiro, A., Siqueira, R., Kanashiro, L., and Neri, H. 2017. Brazilian Public Software Portal: an integrated platform for collaborative development. In Proceedings of the 13th International Symposium on Open Collaboration (OpenSym '17). ACM, Article 16, 10 pages. 5. Davis, Jennifer and Daniels, Katherine, Effective DevOps: building a culture of collaboration, affinity, and tooling at scale, 2016, " O'Reilly Media, Inc." -6. Humble, J. and Farley, D., 2010. Continuous Delivery: Reliable Software Releases through Build, Test, and Deployment Automation (Adobe Reader). Pearson Education. -7. Savor, T., Douglas, M., Gentili, M., Williams, L., Beck, K. and Stumm, M., 2016, May. Continuous deployment at Facebook and OANDA. In Proceedings of the 38th International Conference on Software Engineering Companion (pp. 21-30). ACM. +6. Savor, T., Douglas, M., Gentili, M., Williams, L., Beck, K. and Stumm, M., 2016, May. Continuous deployment at Facebook and OANDA. In Proceedings of the 38th International Conference on Software Engineering Companion (pp. 21-30). ACM. + -- libgit2 0.21.2