Commit 3b00f2de52290922d46c2a0f73c4ae34be8bd19b
1 parent
4617497c
Exists in
master
and in
3 other branches
[i3eSW] Grammarly and minor fixes
Showing
1 changed file
with
10 additions
and
12 deletions
Show diff stats
ieeeSW/releaseEng3/IEEE_ThemeIssue_ReleaseEng_CD.md
@@ -96,7 +96,7 @@ mudar em todas as ocorrências de agents por staff, mas checar com o Fabio. | @@ -96,7 +96,7 @@ mudar em todas as ocorrências de agents por staff, mas checar com o Fabio. | ||
96 | In this context, we overcame two distinct challenges: (1) deconstructing | 96 | In this context, we overcame two distinct challenges: (1) deconstructing |
97 | the widespread belief among government staff that any project in partnership | 97 | the widespread belief among government staff that any project in partnership |
98 | with a University is doomed to fail, and (2) dealing with bureaucracies | 98 | with a University is doomed to fail, and (2) dealing with bureaucracies |
99 | -involved in the deployment process. | 99 | +involved in the Ministry deployment process. |
100 | 100 | ||
101 | Firstly, our team was not from a typical company, consisting mainly of | 101 | Firstly, our team was not from a typical company, consisting mainly of |
102 | undergraduate students supported senior developers and designers, all | 102 | undergraduate students supported senior developers and designers, all |
@@ -110,7 +110,7 @@ Secondly, our team approached software deployment differently from the | @@ -110,7 +110,7 @@ Secondly, our team approached software deployment differently from the | ||
110 | Ministry. We believed frequent delivery is better for the project’s success. | 110 | Ministry. We believed frequent delivery is better for the project’s success. |
111 | In contrast, the Ministry is used to the idea of a single deployment at the end | 111 | In contrast, the Ministry is used to the idea of a single deployment at the end |
112 | of the project, and neither their bureaucratic structure nor their technical | 112 | of the project, and neither their bureaucratic structure nor their technical |
113 | -expertise were conducive with this style of work. That ended up hampering the | 113 | +expertise was conducive to this style of work. That ended up hampering the |
114 | benefits of the tool and preventing us from showing off the fruits of the | 114 | benefits of the tool and preventing us from showing off the fruits of the |
115 | project to those responsible for evaluating it. | 115 | project to those responsible for evaluating it. |
116 | 116 | ||
@@ -132,22 +132,22 @@ project, we became active participants in the deploy operations. | @@ -132,22 +132,22 @@ project, we became active participants in the deploy operations. | ||
132 | ## Our Continuous Delivery Pipeline | 132 | ## Our Continuous Delivery Pipeline |
133 | 133 | ||
134 | SPB portal is a CDE with additional social features. We built system-of-systems | 134 | SPB portal is a CDE with additional social features. We built system-of-systems |
135 | -adapting and integrating five existing OSS projects: Colab | 135 | +adapting and integrating five existing OSS projects: Colab |
136 | (www.github.com/colab), Noosfero (www.noosfero.org), Gitlab (www.gitlab.com), | 136 | (www.github.com/colab), Noosfero (www.noosfero.org), Gitlab (www.gitlab.com), |
137 | Mezuro (www.mezuro.org), and Mailman (www.list.org). Colab orchestrates these | 137 | Mezuro (www.mezuro.org), and Mailman (www.list.org). Colab orchestrates these |
138 | multiple components and allowed us to smoothly provide a unified interface for | 138 | multiple components and allowed us to smoothly provide a unified interface for |
139 | final users, including single sign-on and global searches [1]. All these integrated | 139 | final users, including single sign-on and global searches [1]. All these integrated |
140 | -system represents a total of 106.253 commits and 1.347.421 lines of code. | 140 | +systems represents a total of 106.253 commits and 1.347.421 lines of code. |
141 | 141 | ||
142 |  | 142 |  |
143 | 143 | ||
144 | The portal deployment follows a typical CD pipeline [3], adapted to the | 144 | The portal deployment follows a typical CD pipeline [3], adapted to the |
145 | technical and organizational context of our project and the use of OSS best | 145 | technical and organizational context of our project and the use of OSS best |
146 | practices, as presented in Figure 1. It started when new code arrived; and when | 146 | practices, as presented in Figure 1. It started when new code arrived; and when |
147 | -it reach the production environment, we would restart the pipeline to release | 147 | +it reaches the production environment, we would restart the pipeline to release |
148 | new versions. | 148 | new versions. |
149 | 149 | ||
150 | -<!-- Fabio: Neste ponto eu já gostaria de ter uma ideia do tamanho do sistema [..] eu gostaria de ter outros números como linhas de código [x], quantidade de componentes[x], usuários desenvolvedores esperados[Temos acesso?], etc.--> | 150 | +<!-- Fabio: Neste ponto eu já gostaria de ter uma ideia do tamanho do sistema [..] eu gostaria de ter outros números como linhas de código [x], quantidade de componentes[x], usuários desenvolvedores esperados[Temos acesso?], etc. [atualmente, 83 softwares abrigado no portal?]--> |
151 | 151 | ||
152 | ### Automated Tests | 152 | ### Automated Tests |
153 | 153 | ||
@@ -194,7 +194,7 @@ simplifying the deployment process. | @@ -194,7 +194,7 @@ simplifying the deployment process. | ||
194 | 194 | ||
195 | After a new SPB portal deployment in the VE, we used the environment to verify | 195 | After a new SPB portal deployment in the VE, we used the environment to verify |
196 | the integrity of the entire portal. In this step, Ministry staff also checked | 196 | the integrity of the entire portal. In this step, Ministry staff also checked |
197 | -the new features, required changes and bug fixes. If they identified a problem, | 197 | +the new features, required changes, and bug fixes. If they identified a problem, |
198 | they would notify the developers via comments on the SPB portal issue tracker, | 198 | they would notify the developers via comments on the SPB portal issue tracker, |
199 | prompting the team to fix it and restart the pipeline. Otherwise, we could move | 199 | prompting the team to fix it and restart the pipeline. Otherwise, we could move |
200 | forward. | 200 | forward. |
@@ -301,8 +301,8 @@ process on-the-fly. | @@ -301,8 +301,8 @@ process on-the-fly. | ||
301 | Adopting an unfamiliar approach requires trust. Ministry staff, traditionally, | 301 | Adopting an unfamiliar approach requires trust. Ministry staff, traditionally, |
302 | expected and were prepared to validate and deploy a single deliverable. However, | 302 | expected and were prepared to validate and deploy a single deliverable. However, |
303 | the steady growth of SPB complexity made large deliveries unsustainable. The CD | 303 | the steady growth of SPB complexity made large deliveries unsustainable. The CD |
304 | -approach was necessary. Therefore, we use the following approaches to made this | ||
305 | -new dynamic in the Ministry possible: | 304 | +approach was necessary. Therefore, we developed the following line of action to |
305 | +make this new dynamics possible: | ||
306 | 306 | ||
307 | 1. _Demonstrate actual results, do not simply tell._ Initially, we did not have | 307 | 1. _Demonstrate actual results, do not simply tell._ Initially, we did not have |
308 | access to the Ministry infrastructure, so we created our own validation | 308 | access to the Ministry infrastructure, so we created our own validation |
@@ -326,7 +326,7 @@ the process. They saw the mobilization and responsiveness of our team to | @@ -326,7 +326,7 @@ the process. They saw the mobilization and responsiveness of our team to | ||
326 | generate each new version package. They also recognized the quality of our work | 326 | generate each new version package. They also recognized the quality of our work |
327 | and deployment process. In the end, the Ministry staff realized that it would | 327 | and deployment process. In the end, the Ministry staff realized that it would |
328 | be beneficial for the project if they granted us access to the infrastructure, | 328 | be beneficial for the project if they granted us access to the infrastructure, |
329 | -both VE, and PE. | 329 | +both VE and PE. |
330 | 330 | ||
331 | ## References | 331 | ## References |
332 | 332 | ||
@@ -349,5 +349,3 @@ Considerar: | @@ -349,5 +349,3 @@ Considerar: | ||
349 | https://puppet.com/resources/whitepaper/state-of-devops-report | 349 | https://puppet.com/resources/whitepaper/state-of-devops-report |
350 | 350 | ||
351 | --> | 351 | --> |
352 | - | ||
353 | - |